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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M/M-PLUS Batch and Queue Operations Manual explains’ the 
Queue Manager (QMG). 


On RSX-11M/RSX-11M-PLUS systems, the QMG provides for the orderly 
queueing and dequeueing of print jobs to line printers or other output 
devices. The QMG commands that control these print queue functions 
are explained in detail in this manual. 


QMG print processor operations are controlled through PRINT commands 
and command qualifiers and switches. Files are printed as the result 
of a PRINT command or as the result of a request for a listing or map 
from some system task. 


Each RSX-11M/M-PLUS system is tailored for a particular set of 
software applications that must work within the confines of your 
installation's hardware system. This manual is a general description 
of how batch and queue operations should proceed, but your system 
manager may have special information on these processes in your 
installation. 


INTENDED AUDIENCE 


This manual is intended for all RSX-11M/M-PLUS users. The manual has 
been particularly designed to meet the needs of users new to operating 
systems. 


System managers should consult the RSX-11M/M-PLUS System Management 
Guide for information on setting up and running OMG. 


STRUCTURE OF THIS DOCUMENT 
The manual is organized as follows: 


Chapter 1 Introductory material, examples of how to queue 
print jobs and batch jobs, and how to. get 
information on queue contents. 


Chapter 2 Details on the PRINT command, information on 
displaying and modifying both print and batch jobs 
in a queue, and writing applications tasks that 
spool output. 


Vir 
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Chapter 3 Batch job preparation and SUBMIT commands. 
Chapter 4 At-a-glance summaries of chapter material. 


Appendix A Explanations of all error messages and suggestions 
for appropriate user actions. 


Glossary Definitions of terms used in batch and queue 
operations. 


ASSOCIATED DOCUMENTS 
RSX-11M/M-PLUS Command Language Manual 
RSX-11M/M-PLUS MCR Operations Manual 


RSX11M/M-PLUS System Management Guide 


CONVENTIONS USED IN THIS DOCUMENT 


DCL and MCR are the two Command Line Interpreters (CLIs) used in the 
manual examples. 


DCL QMG commands are generally in the following format: 
DCL>command/commandqualifier file/filequalifier 


The DCL qualifiers either define the operation (command) or modify 
that operation for a file. 


MCR commands, unlike DCL, do not follow 
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general command format. 
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command to another. 


am 
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DCL is presented as the primary CLI in this manual. When specific DCL 
commands or qualifiers are discussed in manual text, they are always 
followed by the MCR equivalents. 


The RETURN symbol has been omitted from the examples. You can assume 
that every command is terminated by pressing the RETURN key. 


A number of conventions are used in the command descriptions in this 
manual. With the exception of /qualifier (DCL) and /switch (MCR), the 
terms and conventions are the same for both DCL and MCR. 


ee The ellipsis (.. .) denotes batch-stream 
elements without significance to the point 
being discussed. 


la: &. 4 Any command field enclosed in brackets is 
optional. 
element 1 Two or more command elements enclosed in braces 
. indicate that you must choose one of the 
° elements when you issue the command. 


element n 
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lowercase 


/qualifier 
(DCL) 


{switch 
(MCR) 


parameter 


filespec 


Red ink 


Shading 
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Any command field in lowercase must have a 
substitute. Usually the lowercase word will 
identify what kinds of substitutions are 
expected. 


Any command element preceded by a slash (/) 
is a DCL qualifier. Command qualifiers alter 
the action of a command they follow. File 
qualifiers modify the action of the command as 
it affects that file. If a file qualifier is 
used aS a command qualifier, it affects all 
files in the command line. 


Any command element preceded by a slash (/} is 
an MCR switch. Job switches alter the action 
of aocommand. You can apply a switch directly 
to the command or to a command parameter. If a 
switcl follows the file, it modifies the 
attributes of that file and all other files 
that follow in the command line. 


Any required field for a command is called a 
parameter. The most common parameters are file 
specifications. Parameters are preceded by 


aaa 


A full file specification includes device, UFD, 
file name, file type, and version number, as in 
this example: 


DB1: [303,5]MORAN. TXT; 2 


Full file specifications are rarely needed. If 
you do not give a version number the highest 
numbered verSion will be used. Some files may 
not have a file type. Many commands wiil 
accept a wildcard (*) in place of the file 
type. See the command descriptions in the 


RSX-11M/RSX-11M-PLUS Command Language Manual. 


In command examples, commands or other’ input 
that the user types at the terminal are printed 
in red. System output is printed in black. 


The symbol GN indicates that you must 
press the key labeled CTRL while you 
simultaneously press another key, for example 
CTRL/C, CTRL/Z, CTRL/O. 


Shaded portions of text describe only one 
operating system. Gray shading indicates that 
the text describes only RSX-11M-PLUS operating 
systems. Pink shading indicates that the text 
describes only RSX-11M operating systems. The 
smaiiest shaded portion of text is a paragraph. 
Portions of text that are not shaded describe 
both operating systems. 
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SUMMARY OF TECHNICAL CHANGES 


This manual reflects changes and additions to RSX-11M Version 4.0 and 
RSX-11M-PLUS Version 2.0. 
The following technical changes described in this manual have _ been 
made to both RSX-11M and RSX-11M-PLUS: 
1. QMG notifies the user when a job has been successfully 
queued. 
2. Job names can be nine characters. 
3. A new 3-digit job number format replaces the up to 10-digit 
job number format. 
4. Processors and queues are now named directly for the device. 
For example: 
Processor LPO for device LPO 
Queue LPO for device LPO 
5. Two new qualifiers (switches) have been added to the PRINT 
(PRI) command: 
/JOBCOUNT:n (/COsn) 
/(NO]JOB_PAGE (/{NO]JO) 
6. Four new qualifiers (switches) have been added to the SHOW 
QUEUE (QUE/LI) command: 
/BRIEF (/BR) 
/FILE (/LI) 
/FULL (/FU) 
/DEVICE (/LI: DEV) 
7. Three new qualifiers (switches) have been added to the SHOW 


PROCESSOR (QUE /LI:DEV) command: 


/DEVICE (/LI:P) 
/ INPUT (/LI:I) 
/PRINT (/LI:P) 
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Three new qualifiers (switches) have been added to the SET 
QUEUE (QUE /MOD) command: 


/COPIES:n (/CO:n) 
/ [NO] DELETE (/[NO]DE) 
/FILE POSITION (/FI:n) 


Two new qualifiers (switches) have been added to the DELETE 
(QUE /DEL) command: 


/7ENTRY:nnn (/EN:nnn) 


/File_POSITION (/FI:n) 


replaces “/NOORIGINAL L and the. 


“longer ee 
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CHAPTER 1 


INTRODUCTION TO THE QUEUE MANAGER 


This chapter briefly introduces features of the Queue Manager (QMG). 


The chapter begins with an explanation of the queue assignments. 
Queues are assigned by system managers. You should consult with your 
system manager for information on queue assignments at your 
installation. 

The chapter also gives examples for queueing print jobs and displaying 
the contents of queues. DCL is presented as the primary CLI in all 
examples, followed by the MCR equivalents. 


Finally, there is a brief introduction to batch processing on 
RSX-11M-PLUS. 


1.1 QUEUE MANAGER 


The Queue Manager is a system program that provides for the orderly 
processing of print and (on RSX-11M-PLUS only) batch jobs. Most 
functions of the QMG are transparent. Every PRINT command, every 
SUBMIT command (RSX-11M-PLUS only), and every request for a spooled 
listing or map from a system program is passed automatically to _ the 
OMG. The QMG then places these requests in the appropriate “queues.” 
A queue is a waiting line of jobs that are scheduled or processed 
according to system or user priorities. 


The Queue Manager distributes these jobs out to batch processors, line 
printers, or other output devices as the processors become available. 
You can check the progress of your job with the SHOW QUEUE commands. 
You can delete a job from a queue if you wish, or you can hold the job 
in a queue for later processing. 


The RSX-1L1IM-PLUS Queue Manager records all its queues in the file 
SPO0:[{1,7]QUEUE.SYS, which is kept on a mass storage disk. This means 
that your job will not be lost if the system should be out of 
operation for any reason. 


Likewise the RSX-11M Queue Manager records its queues in the disk file 
LBO:{1,7]QUEUE.SYS. 
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1.2 QUEUE ASSIGNMENTS 


You should consult your system manager for information pertaining to 
special applications of the Queue Manager at your installation. 
Depending upon the needs of your installation, the system manager 
chooses the number of queues’ to be set up and where the output of 
these queues will be directed. 


Your installation may have certain printers designated to receive 
output for special hardcopy forms (such as_ numbered invoices or 
inventory forms). A listing of these forms and their designated 
output devices will be helpful to you in your understanding of the 
information contained in this manual. Your system manager can supply 
you with a list of these special forms and their corresponding 
devices. 


A single queue can be assigned to one or more devices or to no 
devices. A single device may have one or more queues assigned to it 
or no queues. Figure 1-1 shows some of the possible assignments of 
queues to devices. 


( Queues Processors Devices 


DCL>PRINT/QUEUE:queuename 
MCR>PRI queuename: 


TT3: 


2K-238-81 


Figure 1-1 Queue Assignments to Output Devices 


The /QUEUE:queuename qualifier (queuename:=) to the PRINT command 
directs output to the designated queue. When you do not specify a 
particular queue in the PRINT command, output goes into the defauit 
queue PRINT. In Figure 1-1 the PRINT queue sends output to one of two 
printers. The printers are also served by their device-specific 
queues. The queue CHECKS has not been assigned to any output device. 
Jobs can be placed in this queue, but they will not be taken out of 
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the queue until it is assigned to an output device by the system 
manager. The queue JIMBO and TT3 are both assigned to the same output 
device. 


The same functionality applies for batch queues and batch processors 
on RSX-11iM-PLUS systems. In this case, the default queue is BATCH. 


When a line printer or other output device is under control of the 
Queue Manager, it is said to be a spooled device. Spooled devices 
have been initialized with certain attributes. These attributes are 
defined by the PRINT command qualifiers. Figure 1-2 illustrates the 
way the Queue Manager handles PRINT commands specifying printers with 
certain attributes. 


1.3 PRINT COMMAND 


The Queue Manager handles the orderly printing of files for an 
RSX-11M/RSX-11M-PLUS system through software tasks called despoolers 
or print processors. There is a print processor for every spooled 
line printer on the system. Even if the system does not have a line 
printer, it will have some device designated as the system output 
device. Your system may have as many as 15 output devices to which 
the Queue Manager directs output. 


This output includes all requests to system tasks for maps or listings 
and print jobs entered through the PRINT command, as well as output 
from applications tasks unique to your installation. 


On RSX-11M-PLUS, the output could also include logs from batch jobs. 


A line printer and its associated processor are usually referred to 
simply as a "printer." 


The PRINT command supplies most entries to the PRINT queue. For 
example: 


DCLOPRINT/LOWER/AFTER: (14:00) ERIKA. TXT/COPIES: 3 
MCR>PRI /LOWER/AF: 14: 00O=ERIKA.TXT/COP: 3 


This command queues a QMG print job that prints three copies of the 
file ERIKA.TXT on a line printer with lowercase characters after 2 
P.M. today. The OMG print job has the name ERIKA, which is also. the 
name of the first file in the job. 


Here is an example of a PRINT command naming several files: 
DCLOPRINT/NAME:MORAN/FLAG PAGE KIRSTEN.TXT JOHANNA, ERIKA 
MCR>PRI MORAN/FL=KIRSTEN.TXT JOHANNA, ERIKA 


These files are queued together aS one QMG print job. The . 
/NAME:jobname qualifier (jobname) gives the print job the name MORAN. 
The QMG accepts jobnames up to nine characters in length (the limit 
for filenames). The files are printed in the order listed, on the 
same line printer, and without interruption. The /FLAG PAGE qualifier 
(/FL) means that each file is separated by a flag page bearing the 
name of the file. These file flag pages are in addition to the job 
flag pages that bear the name of the job and that appear at the 
beginning of the job output. 
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The Queue Manager controls line printers through output processor tasks which “own” the devices. Often the line 
printer and its associated processor are referred to collectively as “the printer.” The printer hardware and software 
were brought together in the Queue Manager, when your system manager “initialized” the queues. 


Initialization established the characteristics of the printer. You can then specify printers with those characteristics 
using the PRINT command. 


Default qualifiers to the PRINT command also determine which printer will handle a print job. The following exam- 
ples illustrate the interaction between the PRINT command and the printers. 


Queues 


DCL>INITIALIZE/PROCESSOR 
Processor? LPO/UPPERCASE/- 
FORMS:1/FLAG__PAGE:0 


DCL>INITIALIZE/PROCESSOR 
Processor? LP1/LOWERCASE/- 
FORMS:0/FLAG_PAGE:2 


Printer 
Software 


e Full character set 
* Line printer paper 


® Only uppercase characters 
* Short invoice paper 


Hardware 


LPO: LP1: 


characters; it is initialized with the /UPPERCASE qualifier. The printer is loaded with a special form used in the 
installation, short invoice paper. The printer is initialized with the /FORMS:1 qualifier. The system manager has 
previously defined FORMS:1 for the width and length of the invoice paper. The printer is initialized /FLAG_.PAGE:0 
because the invoices are numbered. Print jobs are printed on the invoice forms. Therefore, no flag pages should be 
printed on the invoice forms. 


Printer LP1: has the full character set and is loaded with standard line-printer paper. Since system output and text 
fiies go io inis prinier, ine prinier is initializea with the /FLAG_PAGE:2 quatifie7, so that any file printed on the 


printer will be identified by a flag page. 


The printer software is set up through the INITIALIZE/PROCESSOR command. Printer LPO: has no lowercase 
| 
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Fig:re 1-2 How the PRINT Command Is Processed 
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DCL>PRINT JPAUL.TXT 
MCR>PRI JPAUL.TXT 


Queues i | LPO | 
| 

| Printer LPO 

| 


DCL>INITIALIZE/PROCESSOR 


Processor? LPO/UPPERCASE/- LPi Processor? LP1/LOWERCASE/- 
FORMS:1/FLAG__PAGE:0 FORMS:0/FLAG__PAGE:2 
® Only uppercase characters e Full character set 
* Short invoice paper e Line printer paper 
LP1: 


The PRINT command specifies no queue, so the job goes into the default queue PRINT. Since the default /FORMS 
qualifier (/FO:) is /FORMS:0 (/FO:0), the job goes from the PRINT queue to processor LP1 and thence to device LP1: 
to be printed. 


Software 


~~ 


| oot >iniiatize/PROcessoR | 
| 


LPO: 


DCL>PRINT/FORMS:1 INVOICE.CHK 
MCR>PRI /FO:1 . INVOICE.CHK 


| 
| Queues LP1 
: DCL>INITIALIZE/PROCESSOR DCL>INITIALIZE/PROCESSOR 
Abel Processor? LP0/UPPERCASE/- LP1 Processor? LP1/LOWERCASE/- 
oi bware FORMS:1/FLAG__PAGE:0 FORMS:0/FLAG__PAGE:2 
© Only uppercase characters « Full character set 
Hardware ° Short invoice paper e Line printer paper 
aad 1 1 
LPO: LP1: | 


! The PRINT command specifies no queue. so the job goes into the default queue PRINT. Since the /FORMS qualifier 
(/FO:) is /FORMS:1 (/FO:1), the job goes from the PRINT queue to processor LPO and thence to device LPO: to be 
printed. 
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Figure 1-2 (Cont.) How the PRINT Command Is Processed 
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DCL >PRINT/DEVICE:LP1:/FORMS:2 CHECK.PAY 
MCR>PRI LP1:/FO:2=CHECKS.PAY 


OCL>INITIALIZE/PROCESSOR DCL>INITIALIZE/PROCESSOR 


Printer Processor? LPO/UPPERCASE/- Processor? LP1/LOWERCASE/- 
Software FORMS:1/FLAG__PAGE:0 FORMS:0/FLAG__PAGE:2 
e Only uppercase characters e Full character set 
Hardware e Short invoice paper ¢ Line printer paper 
The PRINT command specified device LP1, So ihe job goes to ihe aévice-specific queue LPT. The PRINT command 
specified the /FORMS:2 qualifier (/FO:2), however, so the job will not be printed until LP1 is reinitialized to 
/FORMS:2 (/FO:2). In addition, the paper in the machine must be changed. 
DCL>PRINT/LOWERCASE INVOICE.BKS 
MCR>PRI /LOW=INVOICE.BKS 
| Queues { | Heit, a teehee | tpi 
i 
| 
i 
: DCL>INITIALIZE/PROCESSOR DCL>INITIALIZE/PROCESSOR 
Printer Processor? LP0/UPPERCASE/- Processor? LP1/LOWERCASE/- 
Software FORMS:1/FLAG__PAGE:0 FORMS:0/FLAG__PAGE:2 
| L ae 
SS 
s e Only uppercase characters e Full character set 
Hardware e Short invoice paper *® Line printer paper 
Cc 
LPO: LP1: 
The PRINT command specified no queue, so the job goes to the default queue PRINT. The /FORMS qualifier (/FO:) 
is /FORMS:0 (/FO:0) by default. The user specified a printer initialized with the /LOWERCASE qualifier (/LOW), so 
the job goes to processor LP1 and thence to device LP1 to be printed. 
You should note that initialization with the /LOWERCASE qualifier (/LOW) does not necessarily mean that the device 
itself has the lowercase character set. In most cases, it has. but in Smargeneiee, devices without the lowercase 


character set may be initialized wiitn tne (LOWERCASE qualifier (/LOW) so tnat jobs whose PRINT commands 
included the /LOWERCASE qualifier (/LOW) will not be blocked in their queues. 


2 
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Figure 1-2 (Cont.} How the PRI? 
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‘Tint tsp you cal 


The» ‘commands. in the. batch jobs. are passed to. the operating teyet ems by: 
tasks”. ‘called. -batch | processors... There © can: be. as.many: as. 16 ‘batch. 
“processors on. a ‘system. and as many as. “16. batch | “queues. .- All Syetens: 
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1.5 SHOW QUEUE (QUE /LIST) COMMAND 

The SHOW QUEUE command displays information about print and (in the 
case of RSX-11M-PLUS systems) batch queues. These commands are 
discussed in detail in Section 3.4.1. However, the most useful form 


of the command, and its output, are described briefly in the following 
sections. 


1.5.1 SHOW QUEUE - QUE /LI 
The SHOW QUEUE (QUE /LIst) command lists aii jobs in ail queues. 
On RSX-11M systems this command lists the print queues. 


On RSX-11M-PLUS systems this command lists both print and _ batch 
queues. 


Type one of the following commands on your terminal, and press’ the 
RETURN key. 


DCL> SHOW QUEUE 
MCR> QUE /LI 


The information you see on your terminal will be similar to _ the 
information in Example 1-1. 
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Example 1-1 SHOW QUEUE Display 
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identify those elements that appear on _ your 


as a result of a SHOW QURUR (QURFR /T.T) command. The ealements 


are interpreted as follows: 


Shows a print queue or (for RSX-1l1IM-PLUS systems) a batch 
queue header. This header indicates that the information it 
precedes is either for a print queue or batch queue. 


Shows the queue and the spooled devices or batch processors 
assigned to it. 


Shows the UIC of the job. A privileged user may have a 
different UIC from the login UIC. 
Shows the QMG print job name. The name may be composed of 


one to nine alphanumeric characters. 


Shows the job entry number (the range 
The QMG assigned this number’ when 
queue. 


is 1 through 999). 
it placed the job in 


Shows the form number for the printer on which the job is to 
be printed. 


Shows the queue status of a job. 
or BLOCKED UNTIL (time blocked). 


A job may be ACTIVE, HELD, 
Shows the entry order of the file in a job and its full file 
specification. 


Shows the number of copies of a file to be printed within a 
partiicular job, 


CHAPTER 2 


QUEUING JOBS 


The Queve Manager (QMG) is a system task that distributes jobs to 
output devices or batch processors. Passing jobs to the Queue Manager 
is called "queuing jobs." When the Queue Manager releases jobs for 
processing, it is called "dequeuing jobs." 


The Queue Manager distributes jobs queued by user tasks, by system 
tasks that output listings such as MACRO listings or task builder 
maps, and jobs queued by the PRINT command. 


Once jobs are in queues, you can display queue information with the 
SHOW QUEUE (QUE /LI) command. You can alter the status of jobs in 
queues with the SET QUEUE (QUE /MOD) command. You can hold jobs in 
queues with the HOLD/JOB (QUE /HO) command or release them from queues 
with the RELEASE/JOB (QUE/REL) command. 


All these aspects of using the Queue Manager, including writing tasks 
that spool output, are discussed in this chapter. 


2.1 SPOOLING OUTPUT 
A spooled output device is the hardware device plus its processor. 


Spool is an acronym for Shared Peripheral Operations On Line. 
Spooling refers to the process of sending output to a peripheral 
device, such as a line printer, in an orderly fashion. Output 
requests are gathered into queues and then these requests are 
"dequeued" in a serial manner. The spooled device services only one 
request at a time. 


The most common output device for the Queue Manager is a line printer. 
Most RSX-11M/11M-PLUS systems will have a line printer or some other 


device designated as the system output device that assumes the role of 
the line printer. 


On: -RSX-11M-PLUS, you can’ substitute’ the. device ‘name of a spooled 
_output _ device for the output file specification in any elbed task or. 
~user-written task*.that creates an output file... This . called 
. transparent spooling. — Thus, the. ‘following. commands are ‘egal “and. will 
. queue files to an output device:. ; : 


DCLXCOPY MORAN.MAC LPO: 


MCR>PIP LPO:=MORAN.MAC 
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When you successfully submit a job for queuing with either the OMG 
PRINT or SUBMIT command, you will receive a submission notification 
message on your terminal. For example: 


DCL>PRINT MORAN. DMP 
MCR>PRI MORAN. DMP 


The following message will appear: 


PRI-JOB 123, name "MORAN "submitted to queue "PRINT " 

PRI Indicates that the job was submitted by the PRINT command. 
If you use the SUBMIT command, SUB will take the place of 
PRI. 

123 The unique job entry number given to the job (1 through 
999). 

MORAN The name of your job. Jobnames can be up to nine characters 
in length. If you do not specify a jobname, the jobname 


will be derived from the first file name in your job. 


PRINT The queue into which the job is submitted. 


2.2 PRINT COMMAND 


The PRINT (PRI) command queues files for printing on a line printer. 
More specifically, the output you desire to be printed on a line 
printer is first placed into a waiting line by the Queue Manager 
(QMG). QMG places the print job into the waiting line according to 
the job's print status. Status is determined by PRINT command 
qualifiers and switches described in this section. 


The PRINT command can also be used to queue jobs for other output 
devices and applications processors. These jobs are referred to as 
"print" jobs even if they do not involve any hardware printing. 


The PRINT command gives you control over how, when, and where your job 
will be printed through the use of PRINT command qualifiers and 
switches. 
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Format 
DCL>PRINT[/commandqualifier[s]] filespec{s] [/filequalifier[s]] 


MCR>PRI[ [queuename:] [jobname] [/jobswitch] =]filespec[s] [/fileswitch[s] ] 


DCL Command Qualifiers MCR Job Switches 

/JOBCOUNT:n /COsn 

/QUEUE : queuename queuename: 

/ UPPERCASE /NOLOW 

/ LOWERCASE / LOW 

/ [NO] HOLD / [NO] HO 

/PAGE COUNT:n /PA:n 

/NAME: jobname jobname= 

/PRIORITY:n /PRIO:n 

/FORM:n /FO:n 

/LENGTH:n /LE:n 

/(NO] RESTART /{NO]RES 

/(NO]FLAG PAGE /[(NO]FL 

/AFTER: (dd-mm-yy hh:mm) /AF :hh:mm:dd-mmm-yy 

/DEVICE:ddnn: queuename: 

/ [NO] JOBPAGE /NOJO 

DCL File Qualifiers MCR File Switches 

/ {NO]DELETE /[NO]DE 

/COPIES:n /COen 

/(NO] TRANSFER (RSX-11M-PLUS Only) /(NO]TR (RSX-11M-PLUS Only) 
Parameter 


filespec[s] 
Specifies the file(s) to be printed. 
Separate multiple filespecs with commas. You can use wildcards 
(*) ain the UFD and file name, type, and version fields of the 


filespec. 


If your filespec includes no file type, the default file type is 
~LST. 
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Command Qualifiers (DCL) and Job Switches (MCR) 


/JOBCOUNT:n 
/COrn 


Specifies the number of copies (n) of the print job. A QMG print 
job is made up of one or more files that are printed in the order 
they were listed. 


NOTE 


/JOBCOUNT:n (/CO:n) is a qualifier to the QMG PRINT 
command. Do not confuse it with the /COPIES:n qualifier, 
(/CO:n) which is a qualifier to the file(s) contained 
inside a QMG print job. 


/QUEUE:queuename 
queuename:= 


Specifies the name of the print queue in which the job is to be 
placed. The default is the PRINT queue. 


/ UPPERCASE 
/NOLOW 


Specifies that the print job can be sent to a line printer 
initialized without the lowercase character set. This is the 


default. 

/ LOWERCASE 

/LOW 
Specifies that the print job must be sent to a line printer 
initialized with the lowercase character set. 

/{NO}HOLD 

/(NO]HO 
Specifies that the job be held in its queue and is therefore not 
eligible for printing. You can release the job with RELEASE/JOB 
(QUE/RE). See Section 2.8.2. 

/PAGE_COUNT:n 

/PAzn 


Sets the limit on the number of pages a job may produce. The 
range is 1 through 65535. 


Without this qualifier, the number of pages is unlimited (n=0). 


/NAME: jobname 
jobname= 


Specifies a job name for the print job. The job name can be up 
to nine alphanumeric characters. 


If you specify a job name, that name appears on the flag page at 
the beginning of the printed output. Otherwise, the name of the 
first file in the job is the job name. 


QUEUING JOBS 


/PRIORITY:n 
/PRIOzn 


Sets the queue priority of the print job. For nonprivileged 
users, n can be from 0 through 150. Privileged users can set n 
up through 250. The default is 50. 


The Queue Manager runs the highest-priority job first. If two 
jobs have the same priority, the job that has been waiting longer 
runs first. 


/FORMS:n 
/FOr:n 


Specifies the type of form that the job is to be printed on. The 
value of n can be from 0 through 255. Default is 0. See your 
system manager for details on how to specify the particular forms 
used at your installation. 


/LENGTH:n 
/LE:n 


Sets the length of a logical page; n can be any number from 0 to 
255. The default is 0. If you set a length, a form feed will be 
automatically generated if one is not found within n lines. 


This qualifier has no effect on how the printer handles form-feed 
characters. A form feed still moves the printer to the top of 
the next physical form, such as the perforation in a sheet of 
line-printer paper. This qualifier simply adds the requirement 
that the printer move to the top of the next physical page if no 
form-feed character is encountered within n lines. 


When you set the length at 0 (the default), no form feeds will be 
inserted. 


/{NO]RESTART 
/([NO]RES 


Controls requeuing of your job if it is stopped or aborted while 
being processed. 


If /RESTART (/RES) is specified, your job will start again from 
the beginning if it is stopped or aborted. 


/NORESTART (/NORES) is the default. If the printer is stopped 
while your job is active, the job will pick up where it left off 
when the printer is started. 


In neither case will you be missing any of your job, but with 
/RESTART (/RES) your job will be all in one piece. 


/(NO]FLAG PAGE 


/{NO]PL 
Adds flag pages before each file in your print job. The default 
is /NOFLAG PAGE (/NOFL). 


With /NOFLAG PAGE (/NOFL), your job is still preceded by a job 
flag page, but the files in the job are printed without any file 
flag page. (See /[NO]JOB_ PAGE.) 
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/AFTER: (dd-mmm-yy hh:mm) 
(mm/dd/yy hh:mm) 
/AF:hh:mm:dd-mmm-yy 


Blocks the job until after the specified time. Depending on the 
print queues at that time, your job may be run immediately or 
later when its turn comes up in the queue. 


The time and date are in the same format as the format generated 
by the SET TIME (DCL) and TIM (MCR) commands. 


If you do not specify /AFTER (/AF), your job is immediately 
eligible for printing. 


/DEVICE:ddnn: 
queuename: 


Specifies the device on which you want your output to appear. 
The default is the device or devices served by the PRINT queue. 
(/DEVICE is a DCL synonym for /QUEUE.) 


/{NO]JOB PAGE 


/{NO]JO 


Controls the printing of a job flag page before the job. The 
default is /JOB PAGE (/JO). (See /{NO]FLAG PAGE.) 


File Qualifiers (DCL) and File Switches (MCR) 


If you specify a file qualifier as a command qualifier in DCL, 
that attribute applies to all files. You can, however, override 
that attribute for a specific file by using the qualifier as a 
file qualifier. 


On systems uSing MCR, any file specifications that follow a _ file 
specification that is altered by a switch will (by default) be 
altered as well. In the following example, you would have to use 
the /CO:1 switch after JPAUL if you did not want four copies 
printed: 


DCL>PRINT JOHANNA. TXT, KIRSTEN/COPIES: 4, JPAUL, DAD.MEE 
MCR>PRI =JOHANNA. TXT, KIRSTEN/CO: 4, JPAUL/CO:1,DAD.MEE 


/COPIES:n 
/CO:n 


Sets the number of copies for a particular file in a Job. The 
default is one copy. 


/{NO]DELETE 
/{NO]DE 


Deletes the files after they are printed. The default is 
/NODELETE. 


/(NO] TRANSFER (RSX-11M-PLUS only) 
/{NO]TR (RSX-11M-PLUS only) 


Allows the copying of a file from a private device. The default 
is /TRANSFER. 
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Examples 
The following PRINT command examples appear in both DCL and MCR 
syntax: 
1. DCLOPRINT JOHANNA, TXT 
MCR>PRI JOHANNA. TXT 


This example prints the most recent version of JOHANNA.TXT on the 
line printer. 


2. DCL>PRINT/NOJOB PAGE KIRSTEN. TXT 

MCR>PRI /NOJO=KIRSTEN. TXT 
This example prints KIRSTEN.TXT without a job flag page. 
3. DCL>PRINT/JOBCOUNT: 4 JOHANNA. TXT 

MCR>PRI /CO:4=JOHANNA. TXT 
This example prints four copies of the print job JOHANNA, each 
containing one copy of the file JOHANNA.TXT. They are printed 
end-to-end with a job flag page preceding each printed copy. 
4. DCL>PRINT/JOBCOUNT:4/FLAG PAGE KIRSTEN. TXT 

MCR>PRI /CO:4/FL=KIRSTEN. TXT 
This example prints four copies of the print job KIRSTEN, each 
containing one copy of the file KIRSTEN.TXT preceded by a job 
flag page and a file flag page. 
5. DCL>PRINT/FLAG PAGE JOHANNA. TXT,KIRSTEN. TXT, JIMBO.TXT 

MCR>PRI /FL=JOHANNA. TXT, KIRSTEN. TXT, JIMBO. TXT 


This example prints one copy of each file, each preceded by a 
file flag page. 


6. DCL>PRINT/NAME:FATHER/FLAG PAGE JOHANNA. TXT, KIRSTEN. TXT, JPAUL. TXT, ERIKA. TXT 


MCR>PRI FATHER=JOHANNA. TXT, KIRSTEN. TXT, JPAUL. TXT, ERIKA. TXT 


This example prints one copy of each file preceded by a file flag 
page and gives the name FATHER to the job as a whole. The name 
FATHER appears on the job flag page. 


7. DCLOPRINT/LENGTH:55 DAD.MAC 
MCR>PRI /LE:55=DAD.MAC 


This example prints a single copy of the source program file 
DAD.MAC. This source program file does not contain form-feed 
characters. To avoid printing over the perforations, the user 
has specified a logical printed page length of 55 lines. Each 
time 55 lines are printed, the logical page is complete and _ the 
printer moves to the top of the next physical page. 


If you specify a file with form feeds in it, the printer would 
move to the top of a physical page each time it encountered a 
form feed and each time it printed 55 lines before encountering a 
form feed. 
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8. DCL>PRINT/JOBCOUNT:4 JIMBO,DOC,MOUTH. DOC, QUACK. DOC 
MCR>PRI /CO: 4=JIMBO. DOC ,MOUTH. DOC, QUACK. DOC 


This example prints the QMG print job four times. Each copy of 
the print job contains one copy of the file JIMBO.DOC, one copy 
of the file MOUTH.DOC, and one copy of the file QUACK.DOC. 


9. DCLOPRINT/JOBCOUNT:3 LIT.MAC, FRENCH. FRY,APPLE. PIE/COPIES: 2,MOUTH.WSH 


MCR>PRI /CO:3=LIT.MAC, FRENCH. FRY,APPLE. PIE/CO: 2,MOUTH.WSH/CO:1 


This example prints three copies of the print job named LIT. 
Each copy of the print job contains one copy of the file LIT.MAC 
and FRENCH.FRY, two copies of the file APPLE.PIE, and one copy of 
the file MOUTH.WSH. 


Note the difference between the /JOBCOUNT:3 qualifier (/C0:3) to 
the print command and the /COPIES:2 qualifier (/C0O:2) to the file 
APPLE. PIE. If you are using DCL as your command line 
interpreter, the difference between /JOBCOUNT:n and /COPIES:n is 
easy to see. 


If you are using MCR as your command line interpreter the 
differences between the two /CO:n switches may not appear so 
distinct to you. When you use /CO:n as a switch to the PRINT 
command, you are instructing the Queue Manager to print n copies 
of the print job as separate print jobs. When you use /CO:n as a 
switch to a filespec, contained within a print job, you are 
instructing the Queue Manager to print n copies of that file 
end-to-end within that print job. 


10. DCLOPRINT/NAME:SAILOR/JOBCOUNT: 2/DELETE JIMBO. DOC,MOUTH/COPIES: 3, QUACK 


MCR>PRI SATILOR/CO: 25JIMBO,. DOC/DE,MOUTH/CO: 3, QUACK/CO: 1 


The QMG print job has the name SAILOR and is printed two times. 
Each of the two printed listings contains one copy of the file 
JIMBO.DOC, three copies of the file MOUTH.DOC, and one copy of 
the file QUACK.DOC. All the files are deleted after they are 
printed. 


Again note the difference between the /JOBCOUNT:2 qualifier 
(/CO:2) to the PRINT command and the /COPIES:3 qualifier (/CO:3) 
to the file MOUTH.DOC. 
11. DCLOPRINT/AFTER: (12:15 10-AUG-83) JIMBO.TXT 
MCR>PRI /AF:12:15:10-AUG-83=JIMBO. TXT 


This example blocks the job in queue until the specified date and 
time. 


12. DCLOPRINT/AFTER: (10:30) KIRSTEN. TXT 

MCR>PRI /AF:10:30=KIRSTEN. TXT 
This example blocks the job in queue until 10:30 on the date the 
PRINT command was entered. If you entered this command at any 


time after 10:30, the job KIRSTEN would have been immediately 
eligible for printing. 


1 
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3. DCL>PRINT DX0: [303,14]KIRSTEN.TXT 


MCR>PRI DX0: [303,14] KIRSTEN. TXT 


1 


4. DCL>PRINT/NOTRANSFER DXO0: (303,14]KIRSTEN.TXT 


MCR>PRI=DX0: [303,14] KIRSTEN. TXT/NOTR 


Notes 


Once your job is in a queue, you can modify some job attributes 
with SET QUEUE (QUEUE /MOD). See Section 2.7. 


The /LOWERCASE (/LOW) and /UPPERCASE (/NOLOW) qualifiers have no 
effect on the nature of your output. They do not cause your job 
to be printed in uppercase or lowercase. Specifying /LOWERCASE 
(/LOW) means that a printer with the lowercase attribute must be 
used. Specifying /UPPERCASE (NOLOW) means that the printer need 
not (but may) have the lowercase attribute. 


Despite your setting of the /{NO]RESTART qualifier (/[{NO]RES) 
your system manager may restart your job by commands to the Queue 
Manager over which you have no control. See the RSX-11M/M-PLUS 


System Management Guide. 


The job flag pages and the file flag pages have different 
formats. The job flag page shows the UIC the PRINT command was 
issued under on the first line (or the user name on RSX-11M-PLUS 
systems with CPU accounting) and a nine-character job name 
derived from an explicit job name or the file name of the first 
file in the job. The file flag page shows the file name on the 
first line and the file type and version number on the_- second 
line. 
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The /JOBCOUNT:n qualifier (/CO:n) to the QMG PRINT command 
specifies the number of copies of the job to be printed. You 
should not confuse this job qualifier with the /COPIES:n file 
qualifier (/CO:n). A QMG print job is made up of one or more 
files. If you desire to print two or more copies of a file 
contained in a single QMG print job, you would use the /COPIES:n 
file qualifier (/CO:n). 


2.3 DELETE COMMAND 
The DELETE command is used to delete jobs from a queue or files from a 
job. 
Formats 
DCL>DELETE/ENTRY:nnn[/FILE POSITION:n] 
DCL>DELETE/JOB queuename, jobname[/FILE POSITION:n] 
MCR>QUE /EN:nnn[/FI:n]/DEL 
/FIrn] /DEL 


These commands allow the deletion of a job in queue by specifying 
either the job's entry number or job name. You can also delete a 
Single file in a job by specifying the /FILE POSITION:n qualifier 
(/FIsn). 

Parameters 


queuename 


Specifies the name of the queue containing the job you wish to 
delete. 


jobname 
Identifies a job to be deleted from the specified queue. 


The same job name may appear in a queue more than once. HELD or 
ACTIVE jobs will be deleted before WAITING jobs. 


/ENTRY:nnn 
7EN:nnn 


Deletes a queue entry by number. The number is unique. The 
entry number replaces both the queue name and the job name. 


QUEUING JOBS 


/FILE POSITION:n 
/FItn 


Identifies the file by the file's position in the job. 


Examples 
1. DCLODELETE/ENTRY: 301 
MCR>QUE /EN:301/DEL 


This command deletes the job from queue by referencing the job's 
unique entry number (in this example, job number 301). Jobs may 
share the same job name but never the same job entry number. 
When you delete a job by its entry number, you are deleting that 
particular job with greater confidence. It is possible to delete 
the wrong job when a job is referenced by its jobname. Deleting 
a job by its unique entry number protects you from such mistakes. 


2. DCLODELETE/JOB LPO KIRSTEN 
MCR>QUE LPO:KIRSTEN/DEL 


This command deletes the job KIRSTEN by first referencing the 
job's queue, LPO, and then deleting the job KIRSTEN from LPO. 


3. DCLODELETE/ENTRY: 301/FILE POSITION: 2 
MCROQUE /EN:301/FI:2/DEL 


This example deletes only the second file appearing in job 301. 
You may only refer to the file you wish to delete by the file's 
position in the print job (the numbered order in which you 
entered the file specification). You cannot specify the file you 
wish to delete by referring to its file specification. 


Notes 


Associating a particular file specification with the numbered 
order in which it was entered into a queue can be accomplished by 
entering a SHOW QUEUE command (QUE /LI), and examining the output 
on your terminal. See Figure 1-1 for an example of the entry 
order of file specifications. 


Using the /ENTRY:nnn qualifier to delete a job saves’ keystrokes. 
You are also deleting a job with greater confidence. Remember a 
job may share a job name but never a job entry number. If, for 
example, you decided to delete a job by referring to the job 
name, and you have several jobs sharing the job name, you would 
succeed in deleting only the first occurrence of the job and not 
necessarily the job that you wanted to delete. 
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There can be more than one job with the same name from the _ same 
UIC. The DELETE/QUEUE (QUE /DEL) command will delete the first 
job of a given name in the queue. 
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2.4 PRINT JOBS QUEUED BY SYSTEM TASKS 


A number of system tasks can also pass print jobs to the Queue 
Manager. These jobs include listings from language compilers and the 
MACRO-11 Assembler and maps from the Task Builder. Print jobs can 
also pass to the Queue Manager through CLI commands or PIP. 


2.4.1 Maps, Logs, and Listings 


A number of system tasks can create printable output. Examples of 
these are Task Builder maps, MACRO-11 assembly listings, 
batch-processing logs (RSX-11M-PLUS only), and listings from _ the 
high-level language compilers. These tasks are accessible directly 
from MCR or through DCL commands. These tasks follow their own rules 
for spooling output, but when you request that such output be spooled, 
the request will be handled by the Queue Manager. 


You cannot control the printing of such output directly, as you can 
through the PRINT command. Once the jobs appear in a queue, however, 
you can alter their attributes through the SET QUEUE (QUE/MOD) 
commands. See Section 2.7. 


2.4.2 PIP, CLIs, and Output Files 


On RSX-11M/11M-PLUS you can use PIP, the Peripheral Interchange 
Program, to queue print jobs. 


The following PIP command: 
PIP>NAME.TYP/SP 


causes the file NAME.TYP to be queued for printing. The print job 
will have a name derived from the name of the file (in this case, 
NAME), and the SHOW QUEUE (QUE /LI) display will give the file 
specification. 


On RSX-11M-PLusS. systems, you can also .send files directly to aa ine. 
printer. Via. PIP, as shown. in| the command: ce ae 


PIP>LP1:=NAME.TYP 


The print job will. have a ‘name derived from the. name of the’ ‘task, “such. 
as: PIPT1O,. and the SHOW | QUEUE - (QUE /LI):. g@isplay will not give. the. file. 
-specification, but - only: the file ID. number >. labeled FID... The’ job: will 
appear .:in the -device-specific : queue. Ronee arora sae: to. ‘the device you. : 
ee (in: this case, eae oe ee tease, ne 


DC LOCOPY 
From? NAME. TYP 
To? LPl: 
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*WRITE filespec [range] 


*WRITE LPO: 200:400 


2.5 PRINT JOBS QUEUED BY USER TASKS 


There are several methods for spooling output from user-written tasks. 
When you spool output from within a task, you cannot control the 
printing directly as you can through the PRINT command. Once the 
print job appears in queue, however, you can alter its attributes 
through the SET QUEUE (QUE/MOD) command. See Section 2.7. 


2-5-1 Opening a File on Disk and Using .PRINT 


Your task can open a file on disk, output to it, and close it using 
the PRINTS macro call or call the .PRINT subroutine to spool the 
output. (Refer to the IAS/RSX-11M I/O Operations Manual.) 


The file will be placed in the default queue PRINT. 


In FORTRAN IV, FORTRAN IV-PLUS, and FORTRAN-77 on 
RSX-11M/RSX-11M-PLUS, the equivalent is to use the DISP= 'PRINT' in 
your OPEN or CLOSE statement. 


2.5.2 Opening a File on Disk and Using the PRINT Command 


Your task can open a file on disk, output to it, and close it. Once 
your task exits, print the file with the PRINT command. 


is i ot the simplest method of spooling, it is the only 
method that gives you access to the PRINT command qualifier. You can 
accomplish much the same thing using the two methods described in 
Section 2.5.1 by waiting until the job is in the queue and then 
altering its attributes with the SET QUEUE command. 
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If you run your task from an indirect command file or batch job that 
includes a PRINT command after task exit, the difference between 
spooling from within the task or from outside it will probably not be 
noticeable. 


You can also have the task issue the PRINT command by using the SPWNS 
directive. (Refer to RSX-11M/M-PLUS Executive Reference Manual.) 


2.6 SHOW QUEUE AND SHOW PROCESSOR 


You may use the commands described in this section to display 
information about queues, the jobs in the queues, spooled devices and 
(in the case of RSX-l11M-PLUS systems) batch processors. 


The commands described in Section 2.6.1 allow you to access 
information about OMG print jobs fand for RSX-11M-PLUS systems, batch 
jobs). 


A SHOW QUEUE (QUE/LI) command will show all jobs in all queues. 
Qualifiers (switches) can be used to limit the display to specific 
queues, specific jobs, and the like. 
You may examine the contents of your system's queues (in decreasing 
degree of detail) by entering one of the following command qualifiers 
(switches). 

/FULL (/FU) 

/FILES (/LI) 

/BRIEF (/BRIEF) 
The commands described in Section 2.6.2 display information about 


spooled devices and batch processors under the control of the Queue 
Manager. 


2.6.1 SHOW QUEUE (QUE /LI) 


SHOW QUEUE (QUE /LI) displays information about QMG print jobs’ and 
RSX-11M-PLUS batch jobs. 
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Format 
DCL>SHOW QUEUE [queuenamel [/qualifier[s]] 


MCR>QUE [queuename:] [[uic]] [jobname] /switch[es] 


DCL Qualifiers MCR Switches 
/FULL /FU 

/ FILES /LI 

/BRIEF /BR 

/DEVICE fLitP 
7ENTRY:nnn /EN:nnn 

/ FORMS [:n] /FO[:n] 
/NAME:jobname jobname 
/OWNER UIC:uic [uic] 

/PRINT /LI:P 

/BATCH (RSX-11M-PLUS) /LI:B (RSX-11M-PLUS) 


Command Qualifiers (DCL) and Job Switches (MCR) 


/FULL 
/FU 


Displays detailed information about queues, queue assignments, 
jobs, the attributes of jobs in queues, and files that compose 
jobs in queues. 


/ FILES 
/LI 


Displays information about queues, queue assignments, jobs in 
queues, and files that compose jobs in queues. The attributes of 
the jobs are not displayed. This display format is the default 
of SHOW QUEUE (QUE/LI). 


/BRIEF 
/BR 


Displays only queues, queue assignments, and jobs in queues. 


You may examine specific attributes of queues by entering one of the 
FATlAwInea qual ifiers faut tches} 
tbvaistviily yu tltisa a (wwii twill je 


SHOW QUEUE queuename 
QUE gqueuename:/LI 


Displays QMG information for a single queue. The information 
displayed may be for either print queues or (in the case of 
RSX-11M-PLUS systems) batch queues. 


/DEVICE 
/LI:P 


Limits information to print queues. 
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/ENTRY:nnn 
7ENsnnn 


Limits information to a particular job entry referenced by the 
job's unique entry number. 


/NAME: jobname 
jobname 


Limits information to jobs with the specified jobname. 


/OWNER_UIC:uic 
[uic] 


Limits information to jobs owned by the specified uic. 


/PRINT 
/LI:P 


Limits information to Print queues. This qualifier produces’ the 
same information as the /DEVICE qualifier (DCL). 


/ FORMS [:n] 
/FO[:n] 


Limits information to jobs that are to be printed on a_ specified 
form. If n is omitted, the display shows all jobs that are other 
then Form 0. 


Examples 


The following examples show the three different output displays 
(FULL, FILE, BRIEF). (In order to include information pertaining 
to batch queues, the examples were done on an RSX-11M-PLUS 
system.) 


1. DCL>SHOW QUEUE/FULL 
MCROQUE /FU 


** PRINT QUEUES ** 
PRINT => LPO (LP1) 


[7,25] DRGCL ENTRY: 22 FORM: 0 ACTIVE ON LPO 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG:JOB NOLOWER COP:1 
> 1 DBO: [11,34]DRGCL.LST;1 COP:1 NODELETE 
[7,40] LOGIN ENTRY: 24 FORM: 0 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG:JOB NOLOWER COP:1 
1 DB7:[7,40]LOGIN.CMD;120  COP:1 NODELETE 
LPO => LPO 
LPl => (LPL) 


** BATCH QUEUES ** 
BATCH => BAPO 


[7,40] X ENTRY: 23 ACTIVE ON BAPO 
PRI:50 NORESTART LOG PRINT: PRINT 
> 1 DB7: [7,40]X.BAT;1 NODELETE 
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This display shows all information about the queues and jobs in 
-queves. In this example, the Queue PRINT can send jobs to LPO or 
LP1,. LPl has been stopped by the System Manager and is therefore 
not eligible to accept jobs. (This is indicated by the processor 
name enclosed in parentheses.) 


There are two print jobs in the Queue PRINT: 


o [7,25]DRGCL, entry number 22, which is currently being printed 
on LPO 


o [7,40]LOGIN, entry number 24, which is waiting to be printed. 


The attributes of the job are indicated in the display, and _ the 
files that make up each job are also listed. The angle bracket 
(>) indicates which file of a job is currently being processed. 


2. DCL>SHOW QUEUE [/FILE] 
MCR>QUE /LI 


** PRINT QUEUES ** 
PRINT => LPO (LP1) 


[7,25] DRGCL ENTRY: 22 ACTIVE ON LPO 
> 1 DBO: [11,34]DRGCL.LST;1 
[7,40] LOGIN ENTRY: 24 
1 DB7:[7,40]LOGIN.CMD;120 
LPO => LPO 
LPl => (LP1) 


** BATCH QUEUES ** 
BATCH => BAPO 
[7,40] X ENTRY: 23 ACTIVE ON BAPO 
> 1 DB7:[7,40]X.BAT;1 


This display, the default format, shows the queues in the same 
state. It does not show the attributes of the job. It only 
shows the form number of the job and the attributes of the files 
if other than the default values were specified. 
3. DCL>SHOW QUEUE/BRIEF 

MCR>QUE /BR 


** PRINT QUEUES ** 
PRINT => LPO (LP1) 


[7,25] DRGCL ENTRY: 22 ACTIVE ON LPO 
[7,40] LOGIN ENTRY: 24 

LPO => LPO 

LPl => (LP1) 


** BATCH QUEUES ** 
BATCH => BAPO 
[7,40] xX ENTRY: 23 ACTIVE ON BAPO 


This display only shows the names, entry numbers, and status of 
the jobs in the queues. Also, if a form other than Form 0 is 
specified for a print job, the form will appear in the display. 
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2.6.2 SHOW PROCESSOR (QUE /LI:DEV) 
SHOW PROCESSOR (QUE /LI:DEV) displays information about the 
initialized characteristics of spooled devices and (on RSX-11M-PLUS 
systems) batch processors, printers, and other output devices under 
control of the Queue Manager. 
Format 

DCL>SHOW PROCESSOR [processorname] 


MCR>QUE [processorname:]/LI:DEV 


Displays information about all processors. 


DCL>SHOW PROCESSOR/BATCH 


MCR>QUE /LI:DEV:B 


DCL>SHOW PROCESSOR/PRINT or SHOW PROCESSOR/DEVICE 


MCR>QUE /LI:DEV:P 

On RSX-11M/11M-PLUS Systems, shows all Print processors. 
DCL>SHOW PROCESSOR/INPUT or SHOW PROCESSOR/CARD_ READER 
MCR>QUE /LI:DEV: I 


-On-RSX-LIM-PLUS: “systems, shows. ..spooled. card. reader. devices. 
(Refer to Section 3.9.) 
Example 

Enter one of the following commands on your terminal: 

DCL>SHOW PROCESSOR 

MCROQUE /LI:DEV 

information about print processors and (on RSX-11M-PLUS systems) 
batch processors and spooled input devices will be displayed at 


your terminal as shown in the following RSX-11M-PLUS example. 


** SPOOLED DEVICES ** 


LPO <= PRINT LPO 

LOWER FORM : 0 FLAG: 2 

CURRENT JOB: [301,31]CAESAR ENTRY: 59 
LPl (STOPPED) <= LPl 


NOLOWER FORM: 1 FLAG: 1 
**BATCH PROCESSORS ** 
BAPO <= BATCH 


This display shows all information about spooled devices and 


batch processors. In this example, spooled device LPO can 
receive jobs from queues PRINT and LPO. 
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Spooled device LPl has been stopped by the System Manager and is 
therefore not eligible for receiving jobs for printing. 
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LPO is current 


2.7 SET QUEUE (QUE/MOD) 
SET QUEUE (QUE /MOD) modifies attributes given to either print jobs, 
batch jobs, or files that compose jobs in queues. Such jobs and files 
have been entered in queues by either the PRINT command or {on 
RSX-11M-PLUS systems) SUBMIT command. You cannot change the 
attributes of an active job. 
Job Formats 

DCL>SET QUEUE quename jobname/qualifier[/qualifier[s] } 

DCL>SET QUEUE/ENTRY:nnn/qualifier[{/qualifier[s] ] 

MCR>QUE queuename:jobname/MOD/switch[/switch[es] ] 


MCR>QUE /EN:nnn/MOD/switch[/switch[es] ] 


DCL Qualifiers MCR Switches 
/AFTER: (hh:mm dd-mmm-yy) /AF:hh:mm:dd-mmm-yy 
/JOBCOUNT:n /CO:n 

/FORMS:n /FO:n 

/LENGTH:n /LE:n 

/ LOWERCASE /LOW 

/PAGE COUNT:n /PAzn 

/PRIORITY:n /PRIO:n 
/(NO]RESTART /{NOJRE 

/UPPERCASE /NOLOW 


File Formats 
DCL>SET QUEUE queuename jobname/FILE POSITION:n/qualifier[/qualifier[s]] 
DCL>SET QUEUE/ENTRY:nnn/FILE POSITION:n/qualifier[/qualifier[s] ] 
MCR>QUE queuename:jobname/MOD/FI:n/switch[/switch[es] ] 


MCROQUE /EN:nnn/MOD/FI:n/switch[/switch[es] } 


DCL Qualifiers MCR Switches 
/COPIES:n /CO:n 
/(NO]DELETE /{NO]DEL 
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Job Qualifiers and Switches 


/AFTER: (dd-mmm-yy hh:mm) 
/AF:hh:mm:dd-mmm-yy 


Changes the time after which your job will be printed. The job 
will be BLOCKED until the time and date you specify. The job 
will not necessarily be printed at exactly the time you state but 
will be eligible after the time you state. 


If you do not supply the calendar field, the default is the 
current date. If you do not supply the clock field, the default 
is midnight on the date given in the calendar field. 


If you supply both the clock and calendar fields, you must 
separate them with a space (DCL) or a colon (MCR). 


/JOBCOUNT :n 
/COrn 


Changes the number of copies of a job you wish to have printed. 
See File Qualifiers for an explanation of how to modify the 
number of copies of a file contained inside of a job. See 
Section 2.2 for an explanation of the COPIES attribute as it 
applies to print jobs. 


/FORMS:n 
/FOrn 


Changes the FORMS attribute of your print job. See Section 2.2 
for an explanation of the FORMS attribute as it applies to print 
jobs. 


/LENGTH:n 
/LEsn 


Changes the length of a logical page (number of lines per printed 
page) of your print job. A line printer will move to the top of 
a physical page every time n lines have been printed on a page. 
See Section 2.2 for an explanation of the LENGTH attribute as it 
applies to print jobs. 


/ LOWERCASE 
/LO 


Prints your job on a line printer initialized /LOWERCASE by your 
system manager. 


/PAGE_COUNT 
/PAsn 


Changes the limit on the number of pages your job may produce. 
See Section 2.2 for an explanation of the PAGE COUNT attribute as 
it applies to print jobs. 


/PRIORITY:n 
/PRIOzn 


Changes the queue priority of a print job. Nonprivileged users 
may set priorities up through 150. Privileged users may set 
priorities up through 250. See Section 2.2 for an explanation of 
the PRIORITY attribute as it applies to print jobs. 
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/ (NO]RESTART 
/{NO]RE 


Changes the restartability of your job. If you specify /RESTART 
(/RE), your job will start again from the beginning if it is 
interrupted while ACTIVE. If you specify /NORESTART (/NORE), the 
default, your job will pick up where it left off, if it is 
interrupted while ACTIVE. 


/UPPERCASE 
/NOLO 


Changes the attribute of the job from lower- to uppercase. 
File Qualifiers and Switches 


/FILE POSITION:n 

/FI:n 
Changes the operation of /COPIES:n (/CO:) or / [(NO]DELETE 
(/{[NO]DEL) as they apply to a file contained in a job in queue. 
The number n refers to the file position in the job. Use SHOW 
QUEUE to determine its position. 


/COPIES:n 
/CO:n 


Changes the number of copies of a file you wish to have printed 
within a single printing of a print job. 


/(NO]DELETE 
/{NO]DEL 


Changes the delete status of a single file contained in a print 
job. 


Example 
DCL>PRINT/JOBCOUNT: 2 KIRSTEN. TXT, JPAUL. TXT/COPIES: 3 
MCR>PRINT/CO: 2=KIRSTEN. TXT, JPAUL. TXT/CO: 3 
The SHOW QUEUE/FULL (QUE/FU) command output might look like this: 


** PRINT QUEUES ** 
PRINT => (LPO) 


[303,5] KIRSTEN ENTRY: 696 FORM:0 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG: JOB NOLOWER COP:2 
1 DB7: [303,5]KIRSTEN.TXT;1 COP:1 NODELETE 
2 DB7: [303,5]JPAUL.TXT;1 COPs.3 NODELETE 


int two copies of the file JDAULL. TXT instead af the thraa 


copies specified in the initial pr rint command, you would type one 
of the following SETQUEUE (QUE /MOD) commands on your’ terminal 
and enter it: 


DCL>SET QUEUE/ENTRY:696/FILE POSITION: 2/CO:2 


MCROQUE /EN:696/MOD/FI:2/C0:2 
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The SHOW QUEUE/FULL (QUE /FU) command output on your’ terminal 
would look like this: 


** PRINT QUEUES ** 
PRINT => (LPO) 


£303, 51. KIRSTEN ENTRY: 696 FORM: 0 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG: JOB NOLOWER COP:2 
1 DB7: {303,5]KIRSTEN.TXT;1 COP:1 NODELETE 
2 DB7: [303,5]JPAUL.TXT;1 COP: 2 NODELETE 
LPO => LPO 
LPl => LPl 


Note that the file in position 2, JPAUL.TXT, will now have 2 
copies instead of 3 printed. 


Notes 
When you issue the PRINT command (or the SUBMIT command for 
RSX-11M-PLUS batch processing), you specify attributes of the QMG 
job through command qualifiers (switches). SET QUEUE (QUE /MOD) 
command qualifiers (switches) change the matching attributes. 
You cannot change the attributes of an active job. 
You can delete files or change the number of copies to be printed 


by specifying /FILE POSITION:n (/FI:n) in your SET QUEUE command 
line. 


2.8 HOLDING AND RELEASING JOBS 


You can specify that a print job be HELD in queue when you issue _ the 
PRINT command. 


You can release such jobs with the RELEASE (QUE /REL) command. 


2.8.1 HOLD (QUE/HO) 


HOLD (QUE /HO) blocks a job in its queue until it is explicitly 
released. 


Format 
DCL>HOLD/JOB queuename jobname 
DCL>HOLD/ENTRY:nnn 
MCR>QUE queuename:jobname/HO 
MCR>QUE /EN:nnn/HO 
Specifying the job's entry number saves you keystrokes. When you 
reference a job by its unique job entry number, you are avoiding 
ambiguity between job names. The entry number identifies both 
the queue the job is in and its name. If you supply the entry 


number, do not name the queue or the job. 


Remember, jobs may share the same name but never the same entry 


If you name the queue and job, do not supply the entry number. 
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2.8.2 RELEASE (QUE/REL) 
RELEASE (QUE /REL) unblocks a job that has been held in queue. 
Format 
DCL>RELEASE/JOB queuename jobname 
DC L>RELEASE/ENTRY:nnn 
MCR>QUE queuename:jobname/REL 
DCL>OQUE /EN:nnn/REL 
Example 
DCL>PRINT/HOLD/NAME: KIRSTEN JPAUL.TXT 
MCR>PRI KIRSTEN/HO=J PAUL. TXT 


The SHOW QUEUE/FULL (QUE /FU) command output might look like 
this: 


** PRINT QUEUES ** 
PRINT => LPO 


[303,5] KIRSTEN ENTRY: 698 FORM: 0 HELD 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG:JOB NOLOWER COP:1 
1 DB7: [303,5]JPAUL.TXT;1 COPs.1 NODELETE 
LPO => LPO 
LPl => LPl 


To unblock KIRSTEN.TXT, you would type one of the following 
RELEASE (QUE /REL) commands on your terminal: 


DC L>RELEASE/ ENTRY: 698 
DCLORELEASE/JOB PRINT KIRSTEN 
MCR>QUE /EN:698/REL 
MCROQUE PRINT: KIRSTEN/REL 
The SHOW QUEUE /FULL (QUE /FU) command output would look like 


this: 


** PRINT QUEUES ** 
PRINT => LPO 


(303,5] KIRSTEN ENTRY:698 FORM: 0 ACTIVE ON LPO 
PRI:50 LEN:0 PAGE:0 NORESTART FLAG:JOB NOLOWER COP:1 
> 1 DB7:[303,5]JPAUL.TXT;1 COP:1 NODELETE 
LPO => LPO 
LP => LP] 


Pe a 


Note, the HELD status of the job in the previous example was 
first changed to WAITING, and then, since there were no jobs in 
queue, became ACTIVE. 
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PREPARING A USER BATCH JOB 


Toaged ‘into “a ‘virtual terminal. 


<7 a A USER, BATCH JOB. 

oe user. ‘patch: Jol “must. “duplicate, : “a complete. ‘daberact ive. eépmitial 
session. | It must issue commands and supply. data to any tasks that run . 
ee the virtual terminal. ‘Labels and sequence control commands “make © 


possible for - you to. Program. PrESPOnsee:. to errors from within. oN 
eee batch job. 5: o. 


PREPARING A USER BATCH JOB 


- 3 “THE BATCH ‘COMMAND. LINE. 


‘The general format of the batch command, line eda > fee 8 
“${label: 7 ‘(eommand] | | 


> ari commands in ‘patch SoBe: must ‘be s precedes ‘by a Goltar sign (8). the. 
dollar sign’ (8) informs the batch processor that the line is te ‘be 
interpreted as a command, and not as. data. The dollar sign ($) is not | 
part of the command . 


sGoiasnaecmay: be . batch- sapeeienes: <snuanes ¢ designed exclusively for 
batch processing, or CLI commands like. DCL. and MCR commands... 
 Batch- ~specific commands work with CUTS s ‘not as” BER Tag ene es: for CLIss.” 


‘There are certain: DCL ‘and MCR éommands that ne a not be “ised” ‘in 

“batch jobs. The DCL. commands. LOGIN and LOGOUT and, their. MCR | 
equivalents HEL and BYE are not necessary. The — batch — commands. $508 
-and SEOS. “perform: the: login and logout. functions of a CLES! ee Stee 


“any: line. can: . have @ label consisting o Na ‘feo! “one’s to. -six. Sharaener ad 
terminated. ‘by oa Cz). in The label. may ‘be bececenced ‘by a GOTO.” 
eee 


appearing: “elsewhere. : ane ‘baten seeing ah Space. a 
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CONTINUE 


The JOB. command. marks the’ beginning of a user batch job and. must 
t if first. in each.file ina OMG batch job. Cire er ek 
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St you need not “Tael dea UIC; “¥ i musk the: 
| .brackets. -. The” ‘UIC. is: ‘the. ‘UIC under which the Submit command Was, 
entered. 


i: you do not inciude: a. UIC, then any. user “who has read. access to. 
~ the file can’ “submit. the job. 4: oat he.” ae “Ee 
Tf ‘you include a ‘utc and you are non- Spray Vegeax the UIC must be 
the same UIC that the SUBMIT command: will be issued under. It. 
need not be the same namber. as- that. of the DED. where the batch 
job Cile is Kept. © . bg WEo te 


erigiiess users can have ee batch bobs 165 in under any UIC. 


If you use the slash format. for the UIC [g/m], you: can suppress 
most login messages. If you. do not PEST EY. a UIC, login messages 
will not be Suppressed. ca eg 
“Command ‘Qualifiers: - 
: prime: (bh: auyte 
eee ee ee 
/TIMErm | | ee, ae 
at a ‘Timits the job. to hours. (hh) and minutes: (mmm) of cpu “times the 
er ies is ‘three. minutes. oe eel eee 
‘Examples: 


| Ae $708 


OS this i is: the’ ‘simplaat: torn of oo ‘Jos éommania; Tt “togs. oe - 
“onto a “terminal. _ - The UIC is the same. as” the are. the: SUBMIT 


. ceomnand was “issued. -undér.? Informational... 
we ee: in. ‘the: batch. Logs." eee 


. this. example logs | the user ‘in under (29, 20), and suppresse 
_ messages... a eee eee oe oe nas 
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| processor assumes. an “BOS command. 


a the ‘OMG bane ae ‘includes ‘kwoOr mote user: sere jobs; 1é. 
. . bateh processor logs out the first user- batch job- before” ity 
2, continues with. the next. user: batch: Hee in the: batch. chain. ae 


oe 4, 3 “DATA 


The DATA command marks ‘the epeebanind: of a data block inebaded. in.. the 
batch job. EOD is required to end the data block. Data is any 
required user input, other than DCL, MCR, or any. other CLI. commands. | 
The DATA command is optional unless one of its qualifiers is needed... 
When used, the DATA command in batch jobs: ‘Should "immediately follow: 
the command that requests input. | ge wy _ 
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quant Etee “ate Fengehy 
“The. batch. “processor ignores. SE 


ake 


SRENAME 


‘BEATLES. FAB a 
ee ee 
_§$PRINT PEPPER. SGT 


_ RENAME 
SDATA 
BEATLES. FAB. 
PEPPER.SGT | 
SPRINT PEPPER. SGT 


The two examples are equivalent. - They rename _ BEATLES. FAB to_ 
PEPPER. SGT and ‘print PEPPER. SGT. am : oe BY cay Sas 


The data: is input for ‘the: RENAME. command. In the first eeaapieg 
the first line. without the dollar sign ($) is taken as data,. 
because’ the previous command: called for user input. In the. 
second _example, the. DATA command identifies the following text as. 
a data block for thé RENAME.command. In both examples, the ne 
. = BOnyae Bian. 18). encountered mare the end of. ‘the. data: block. ie 


ae - $RUN BILL. TSK 
| SDMMA/DoLians 
meerst 


“pesttion=. 
ass “the ta nstead “im rer 
 emesnge EOD is: fears to: end. “the: ‘data: blocks 
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ut a 
‘ Tre ‘you do" net: vapeoi Ey" the: “/DOLLARS: 
sign, 8h encountered closes Ene, paeee 


ee ae ee ae 


“obs command marks ‘the end of | ‘a ‘data block. 
aan hae os . : 7 ree 


eo 
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; one STOP ‘command. ithout..a- qualifier: is: a. batch- ~specttic command . 
A. STOP command followed bya. ‘qualifier. or. any: other. command | Tine. 
_s element. will be ‘Passed to. the: current. bh. Ree = em ae 
te ‘the’ ‘patch processor ‘reaches a “STOP command , ec a 
_ command - equivalent to an EOJ command. You can nave more than one: 

STOP command. in. a ‘Baten: Jobs. when it is. used with the GOTO, ON, 


Of LE command . in ; . 
If the ‘ois batch {ab tiSiaack chother Wie¥" baton job.” the “bsteh 
proces=t continues with “Ene next. user batch job. ; 


You can ‘sop a QMG job- Unceractively. with the. DELETE/JOB or 
_. QUE/DEL command. See Section 2. ae 


3.4.6 CONTINUE 


‘The CONTINUE command isa “no-operation. Tt can be used alone or with 
the ON or the IF command. : in pe : Bl 


‘Formats ae 


TT} 
con U 


_ SON WARNING. ‘THEN. CONTINUE 
mie eae 


. Poe the. most pare this: command is used. with. the IF or: the ON 
command... Its main use.. “to _keep~ the batch) processor. from. 

_.. Stopping the job. when it ‘encounters a. ‘Status. ‘return code other 

_ than SUCCESS. os i foe See eh at . ob ee bags 


i. e 7 “GoTo. 


The. GOTO command directs the. eaten processor: to alte: diréctiy - to. oe 
“line beginning | with: ~ specified- iabel. and. continue Procees tng from 


‘there. it. can be: used: gas -or with. the. ON. or the IF command. 
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“The ON command defines an exit status code and specifies the action to 
be” taken. by the batch processor when that code or a more severe code 
is returned by subsequent commands and tasks. The default. setting is: 
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SON WARNING ‘THEN enor 


This” is the default ‘setting. TE you do not owere 


: other ON command, then. any WARING. or. MOx 7-7 a7 r & a a ro 


code” will _Stop the batch aeons 


SON, ERROR THEN GOTO NEXT 


Never it executes this command, the batch processor ignores” -all. 
. WARNINGS. Whe it receives an ERROR oc SEVEREERROR code, it goes 
directly to the line labeled. $NEXT: and processes the command 


and all BUpSedpent commands following the pees i 
Notes 


once ae ‘condition. specified by. the ON command is. encountered,’ 
_the - command is canceled and the default setting, . ON eG: 
THEN: STOP, is restored. You can reset the .ON. command .at: any: 
point ine ‘the user batch NOW it ae 


PA theo “gonditions ‘that. Coroauee: dae particular “status” a 
 creeine: individually Ay each system task. 


~The ‘ON. command “remains ‘set: “until superseded » a 
“command, by" the specified error. condition, bya SET: oO. 

(Section 3.4.9), or. ee the: and. of the. user | as 
With. one command. ee ae 


ueD 1200, 


aces of tlle -seauence TSK, and SEVERE. TSK. 


3-10 
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“Lo. ..IF SUCCESS is not. legal. 


"Tf ne code is returned, the batch processor assumes SUCCESS. 
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-" $RUN OLD. TSK. 

_» - $GOTO REST | ae 

ae SORAN Sore: 

~ 8 <“SBRO. TT10: WARNING S REC 
: Bae EO | a 


Notes. 


ie the status code. specified in any of th F. co ands matches. 
'. the task's exit status, the specified ie aries ‘taken. ang - oy ON: 
command in- effect iss aqnoted hs ee ee ee Sige 


ote. the status codes in any of the IF- commands: go. match ‘he: task's 3. 
- exit srOruss then the ON command: ae “enabiedy ‘takes. effect. 


3. 4. 11 Comments a 


The exclamation point (!).is used to ‘include comments in the a aeen 
log. It is the only comment character that should be used. in user: 
batch jobs. . Soe ; 


The batch processor naaee not send text. ieccedea : eee the exclamation. 
point (!) to the CLI. Comments beginning with any other characters. 
will be passed to the CLI. and could | cause problems with Pere 
processing... . Send, ake Pe, ttt see. ERS eo ee ite 


. Si connen® ; Rts a 
vod | SUlabels Jbatch- -specific command. {comment 


: ‘This field can include. any: character. » 7d ‘ 
note process anya that | appears after: the. exclamation point. 
((t). A } a te ae : 


Somes 


= SISBIG. QUEST ron? 


cane utaees happens. The. Line. “felidwing the. “#xel mat on age 
- appears.in the batch loge: ©: yo%° et eee ee ee 
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act yo Z 
dev. ce: on. a. “arive o vad: mount. ‘the. volume. before you can. ‘issue. 
“commands” involving that VO z s ; 


This: is’ not always: convenient. or: ‘possible. if you want your ‘batch. “Aob 
-to - run. your .absence ata later time. ‘First, you have no. way. of. 
determining which drive. will* be available when it is time for your job 
be run, cand,- second; you: will need an ‘operator ‘to’ load the device 
ona mount. ‘the. volume when ‘the: drive. does become available. é 


‘The: ALLOCATE. command: has a. eavasee that. handles the first problem, and 
the MOUNT command nas a per’ tat handles the second problem. 


It is. ; necessary to fire: “include. a generic ALLOCATE command “in your. 
‘batch. Job. | The command format is as follows: ee Or a 


(DCL) ‘$ALLOCATE: [/TYPE: devtypel- ad dann. . 
(MCR) SALL dd=ddnn: [/TYPE:devtype] ee 
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aS INO: ice ft 
a SDISMOUNT - ino: 
».. SDEALLO. INO: 


| SBOT ; 


ae this” exanple: yon a6: moe know. the. physical device name, So you 
give ita fog ea device name 7. INO:. 


¥e you” een to. Youd: ane: Heavies: eoueeale on a specific ree 
you .need only use. the standard form of the ALLOCATE and: MOUNT 
. command. as shown: in the following examples © 


a $1. This. ‘pateh: “Feb air get a full aiteckoey: listing re 
pees aoe of. an RLOL disk that. is. already loaded and Spun: up. ee 


TERMINAL. MCR 
OU. DLI: IMREADY- 
P LPOy=DL1:{* 


“being queued; one™ ‘or more: ust 


er.batch jobs become a-OMG” batch job... 
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tes is” CHD. $ 


‘Command qualifiers (Job Switches) 


(/BETER: (dd- mmm—yy - hh :mm) - . 
ee | (mm/dd/yy hh: mm) . weed 
sa hh: mm : dd- ~fammnyY ipsa 


Blocks” the aa! unti2 after’ the. ‘specified: time. ‘Depending ‘on the a 
batch queues at that time, your job may be run- immediately or 
later when its turn comes: up in the: queue.:>.. 


ay en ibe” fron 00 to. 99 
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“yy the Vigee suirehc. your. 


waa 4g see ee P inva! 


Z. 
obs. in- the paves: are’ aespooled 


i Aen 
bai a Bd 


xe} £ 
ap after. othe 


ts a ae o 
° ate ad en a 1 


-/ [NO] HOLD. 
of INOTHO.. . 


mw eat ee 


Specifies that ie a6 be held in its queue. “You can release the 


job with the REELS command . 


/NAME: jobname 
jobname= 


Specifies a re name for the OMG Baten: job. ia aa be 


_ up to nine pas edaaec a Cheracterss 


Pate you Speci te a job name, that name. appears. in ‘ene houkpue’. from 


SHOW QUEUE. (QUE /LI) commands. Otherwise, the file name of the 


first) file specification submitted will be used as fhe job fame. | 


2 age you Hage specified /NOPRINT (/NOPRIN) and. a ot name, “then: the 
_- ° permanent. ‘file. copy of- the. batch ee will have. the. a name ou 
its file name and the type: LOG. % 


PFs Note. that: ‘individual jobs| in. eke ‘hain, can: “label. their. . portion: “of. 
othe log. ‘with. the. label field Of the JOB ead cee ee Baa 


JINO)RESTART 

7{NOIRE 

ee whether” ae 
Re eee n ets Tf: it. is interrupted for’. RY’: reaso : 


RESTART. (RB) ‘means. the: “job win begin again at. ‘the beginning. “ies 
it is aborted... 0:95 - ee ce ee 


1ot a Pen ‘should retarted ‘from the: 


“the default is  /NORESTART ‘(/NORE).. | oe nonrestartable job is. 


(eer eee is deleted. ‘£rom the: queue. oy 
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Que Dhaene “runs. a 
abe ne. the same. > priority, 


o delete the file: or files. sfenksthos: 
shana is. peas a 


stem. should. foe temporary copies: 
ubmitted — “from 2 epee mounted on a™ 
- default - -/TRANSFER  (/TR). 
-he volume: and deal iacate the device: 
after the ‘SUBMIT command . roe 


) “no copies will ie aoe and: 
ane fhe device allocated until” 


te the: OMG batch seb) ‘and - ‘che: eg £ive; if cone is: 
“Th: - lvappear. inthe page heading of the log. 
Then : ~also-appear - inthe display from the SHOW 
(QUE /LE) command . If. each do hot epoca EY a name, the name 


"Suppresses ‘the creation of a sea ‘file. The default” is /LOGFILE 
(f/L0). BO pith och iinet fam uy a a . a _ 
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“MCRSSUB /PRINGIANE. BAT 


ae /PRINT (qualifier: (/PRIN)- ee ee 
“equivalent: to the previous one. te ieee Same oe eee 


Ree | DOL *SUBNIT/NOPRINT GAN Es BAT - 
MCR>SUB /NOPRINSJANE. _BAT 


“Tn this example, a. permanent. iba: file. is created in your  UFD. 

- After the batch job completes, you: may examine the log file™ 
JANE. LOG . at’ ‘your terminal or: use: the PRINT: ‘command pans vapoe™ it: ton 
oO a line. printer... : ; aoe 


4. DCLSSUBMTT/MOLOGETLE. JANE. BAT 


oe  MCRSSUB | /NOLO=JANE. BAT 


no log file is “Produced. eo kage Bes 


te: this. example, n 


peL su IT BABY. BAT, BOY. BAT, MAN, BAT, OLD BAT 
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ersion number of t the patch processor. 


mo hy year, and. time ‘the batch: job began 


Batch: ‘log page mune 


% Task name ‘Of the batch processor — 
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oe EXIT STATUS ‘MESSAGES 


“There: are three Line. identifiers that appear. in the space BeEWOeH: “the - 


time : “stamps and tne command © lines in the log file. These. identifiers 
are. TERM»: DATA, or SKIP. 2 it a 


“TERM identifies the line as output from a baek to the virtual. 
terminal. - ero ae 


DATA identifies the line as input data ‘to a task. 


SKIP indicates that the line. was skipped because. of a GOTO. 
command. ; 


Periods that. appear. below. an identifier . indicate a continuation. of © 
that particular line identifier. - “a 


‘Your batch log file may also contain a message that indicates that the 

ee level in a Peevey. ON: command has been met or ara when _ 
ranges 3- i “through 3- -4 show | user. batch jobs and. ‘the. Log. Hise St, 
Example. 3- -20 shows ‘the: output for) ‘the user batch Hon ‘an ixcapl a! aS 1. ae 


‘The UIC. -is not. specified in»the job but is displayed ‘in the user SOD, 
flag. The systen, pecuisc alee Ais alas are not suppressed. . ee ier ed 


“Note. when: ‘data’ appears. on- “thee ‘same line asa: “Prompt, ait, causes. ene: 
ees to be labeled TERM. rather than. DATAL eo wn Be 


“AL So, ‘note diet vice the Gord: specified fee ON. dha’ IF ene is” 
-enabled, the lines that are skipped are labeled” @S SKIP.) ce ss 


PREPARING A USER BATCH JOB 


Sh. Generate. and. PE go ore enna 

oon “$y. bg ae oP ie Boe. x iy fae 
ie. SON” ERROR: ‘THEN, ‘Goto ‘TRY EW i‘ 

Wace ae CA LENDAR © 


(continued on next page) 
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io deeb am M.. “PRI. =- - Queue. ‘does. not | exist 

cll: 04: 03. ©“ SIP ERROR: THEN - GOTO DIFFQ” 

oe “SKIP. -$STOP > | re ee a 

Sale 04: 04 ‘ess: SDEFFO: “PRI: LPO: /HO= 1984. CAL/COr1O LG etek scale By FP he 

lies -TERM.... PRI. - Job 850,. name "1984 ", SU ubmitted. to, queue AERO 

ier 04: 08. _— “$sTOP grt <8 — . ; o ow 
TERM ~~ Connect. eine: - . mins. _ 
a eee CPU time used: 4 = secs. 

- Task total: 16° . xe 


In Example 3-3, PIP requires input from the virtual terminal TI: to | 
create the file GREET.FTN therefore, the program itself is identified ve 
as DATA. Example (3-4 shows | une eet file for the, user “Pacel ack in. © 
Example 3-3. ” ae . ; Buu, Titans aun See yee cure 


"PROGRAM GREET 

Logica. NAME (15 

+ WRITE.-(5, 90), Se ae 
aie PORN . What is your: name, pl 


CALL EXIT. 
BND * oe 

- $FOR GREET=GREET a es 
~ SRUN GREET: priors eer - 
“Napolean: Bee 
-“$PIP- GREET. Ks ;+/0E . 
SEOT ee Cee 
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allows” you y to ‘submit a cera: deck, - | 


+ You do not neve too. 


When. a-. card reader is spooled, it ee owned. by: the: “Gard. Reader» 


Processor (CRP): ‘and. other ‘tasks. cannot. access it. When. “you place. oe 
- deck of cards in the hopper of a spooled card reader and press the ~ 


RESET .button.on the reader, CRP reads. the- deck, copies the cards to a 
~ file, and: reuusats the Queue Manager to create. a job containing this 
“file... While: batch job submitted from an interactive terminal may 
“cgontain . several aes executing aS a separate batch job, the 
-Ssentire: Geck.. “of cards. read - into: a: single: file and this file is 
"submitted as one batch job. - 


You may. also submit a deck. ae hres to be Sine cas You can then check 
_ the listing for the accuracy of the card deck contents. . 
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- nd NT cards: have™ a format similar’ to. the: “format, “of: 
the” DCL. commands’ ‘SUBMIT and PRINT. They identify the beginning | of a. 
““eard’ deck and determine whether. the. ‘cards. will be submitted for batch. 
“processing. or: printings Wey ste described in more: detati: in pect tone. 
3s 9.1 and 3. 9. 2a a ae : a eee . we 


~ The $PASSWORD card. is. “used. “to: speci ty. your. ee This Siaute oe 
. the same password » that you. “use to. login to an interactive terminal. 
“It is used with username or user UIC information “specified “on the 
$SUBMIT or SPRINT card to acet rey and pen oe you to enter batch 


“The next cards in the deck make up the actual batch job. These are 
Sacies to 2 file the + is then. Soe Se to. 2 hatch. OF. eee queue. ee 


The end-of- -€ile. card is used. to ‘signal | the end of your card deck. tt 
~ consists of the ‘punches aerial bale in column one. ‘This card is 
not copied - ‘to the- ee we , 2 has, ey 


Example 3-5. shows a user: ‘batch job that is. .to be. submitted ne the Card 
Reader Process. —- " 


-eeampie 3 See ee ee ae 
: ~ sguamrt/QUueuE:t :BRT2/PRINT: :LPL/USER: KENT KRYPTON — 
“). - SPASSWORD CLARK | | 

 $JOB XRAY” 20/20), 
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“You: ‘may. not speeify Soh ie ye not: spe me 
es will (default the name INPBATCH | (unless | your. 


SEQUENCE 


/SEQUENCE is. eapecitied. columns’ 3° eneough, 80. ger. each » card: 
will be’ interpreted as a sequence field. A se juence field. may. 
“~ gonsist of any eight alphanumeric characters. In a ‘sequenced: 
-..' Gard deck, the sequence fields should be. ‘ascend ing. from one card 
-.. to the next, although not necessarily by any fixed amount. 
. (MYJOB335, MYJOB336, MYJOB447 is a valid sequence, for example.) 
.. .. A sequence field consisting of all blanks is allowed anywhere in 
the. Becker evan ‘No. i BEQUeR ee fields may apeesh on: control 
gards. : ¥. 8 ea 
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checks. the sequence fiel« 
n d. Tt 


| oe | 
/{NOJHOLD | 
/{NO]JOB_PAGE ~ 
/LENGTH:n ve 
/LOWERCASE 
| /NAME:jobname. - 
(/PAGE_COUNT:n 
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onet ‘been re a at. alls ae S 


~ encountered _ before: the hopper empties, CRP. : ‘starts. reading “and - 
_ Processing” ‘the: next groan: of Saree. ac a new job. Sere a 


“When any of these errors occur, ‘you can remove your gard ‘dean: £¢6it: the. 
aroaee reader. eres Cen correct: the. problem, and put the -cards back in 
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CHAPTER 4 


AT-A-GLANCE GUIDE 


This chapter consists of summaries of command information from the 
previous chapters. These summaries do not include full information on 
the commands, but just enough to remind you of how the commands work. 


The commands covered in this chapter are listed below: 


BATCH-SPECIFIC Commands (RSX-11M-PLUS) 
SUBMIT (SUB) (RSX-11M-PLUS) 

SHOW QUEUE (QUE /LT) 

SHOW PROCESSOR (QUE /LI:DEV) 

SET QUEUE (QUE /MOD) 

HOLD (QUE /HO) and RELEASE (QUE /REL) 


DELETE (QUE /DEL) 


4.1 PRINT (PRI) COMMAND 


PRINT queues files for printing on a line printer. It may also be 
used to queue jobs for other output devices. 


Format 
DCL>PRINT/commandqualifier[s] file[s]/filequalifier[s] 


MCR>PRI [queuename:] [jobname] [/jobswitch] [=]file[s] [/fileswitch[s] ] 


DCL Command Qualifiers MCR Job Switches 
/JOBCOUNT:n /CO:n 

/ QUEUE :queuename queuename: 

/ UPPERCASE /NOLO 

/ LOWERCASE /LO 

/ [NO] HOLD /(NO]HO 

/PAGE COUNT:n /PA:n 
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/NAME: jobname 
/PRIORITY:n 

/FORMS:n 

/LENGTH:n 

/(NO]RESTART 

/{NO]FLAG PAGE 

/AFTER: (dd-mmm-yy hh:mm) 
/DEVICE:ddnn: 


/NOJOB PAGE 


DCL File Qualifiers 
/(NO]DELETE 
/COPIES:n 


/(NO]TRANSFER (RSX-11M-PLUS Only) 


fou fe 5 eee Se ed aw eee _ 


jobname= 

/PRIO:n 

/FO:in 

/LE:n 

/{NO]RES 

/(NO]FL 
/AF:hh:mm:dd-mmm-yy 
queuename: 


/NOJO 


MCR File Switches 
/{(NO]DEL 


/CO:zn 


DCL file qualifiers override settings of command qualifiers. 


The default file type for PRINT is 


If you want your job restarted, you must use the /RESTART (/RES) 


qualifier. 


For /AFTER: (/AF:), omit the 
today's date. 


field to default to 
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see STOP stops the batch job. It can be used ‘alone or with ON or IF. 


 $STOP — 


SON status-code THEN STOP 


$IF status-code THEN STOP = oe) eee 
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used alone. or with ON or ABA 


-$coTO abel 


The label can ees any | six "alphanumeric. ‘characters. There is no. 
- $label: [command] oe ee Mess, aM 
ae label must be terminated by a ‘Solan c el 


© GOTO may reference forwards or ‘backwards. 
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4.4 SHOW QUEUE (QUE/LI) COMMAND 


SHOW QUEUE (QUE /LI) displays information about QMG print jobs and (in 
the case of RSX-l11M-PLUS systems) batch jobs. 


Format 
DCL>SHOW QUEUE [queuename] /qualifier[s] 


MCR>QUE [queuename:] [[uic] ] [jobname] /switch[s] 


DCL Qualifiers MCR Switches 

/FULL /FU 

/FILES /LI 

/BRIEF /BR 

/DEVICE /LI:P 

/ENTRY:nnn /EN:nnn 

/FORMS[:n] /FO[:n] 

/NAME: jobname jobname 

/OWNER UIC:uic fuic] 

/PRINT /LI:P 

/BATCH (RSX-11M-PLUS Only) /LI:B (RSX-11M-PLUS only) 
Notes 


There are no prompts from this command. 
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4.5 SHOW PROCESSOR (QUE /LI:DEV) COMMAND 
SHOW PROCESSOR (QUE /LI:DEV) displays information about the 
initialized characteristics of batch Processors (RSX-11M-PLUS 
systems), printers, and other devices under control of the Queue 
Manager. 
Format 

DCL>SHOW PROCESSOR/qualifier 

MCR>QUE [processorname:]/switch 


DCL Qualifiers MCR Switches 


processorname/[:] /LI:DEV 


/PRINT or /DEVICE /LI:DEV: P 


4.6 SET QUEUE (QUE /MOD) COMMAND 
SET QUEUE (QUE /MOD) modifies attributes given to either print jobs, 
batch jobs, or files that compose jobs in queues. Such jobs and files 
have been entered in queues by either the PRINT command or (on 
RSX-11M-PLUS systems) SUBMIT command. 
Job Format 

DCL>SET QUEUE queuename:jobname/qualifier[/qualifier[s] ] 

DCL>SET QUEUE /ENTRY:nnn/qualifier[/qualifier[s] ] 

MCR>QUE queuename:jobname/MOD/switch[/switch[s] ] 


MCROQUE /EN:nnn/MOD/switch/[/switch[s] ] 


DCL Qualifiers MCR Switches 
/AFTER: (hh:mm dd-mmm-yy) /AF:hh:mm:dd-mmm-yy 
/JOBCOUNT:n /CO:n 

/FORMS:n /FOrn 

/LENGTH:n /LE:N 

/ LOWERCASE /LO 

/PAGE COUNT:n /PAszn 

/PRIORITY:n /PRIO:n 

/ (NO]RESTART /(NO]RE 

/UPPERCASE /NOLO 
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File Format 


DCL>SET QUEUE/ENTRY:nnn/FILE POSITION:n/qualifier[/qualifier[s]] 


DCL>SET QUEUE queuename jobname/FILE POSITION:n/qualifier[/qualifier[s]] 


MCROQUE /EN:nnn/MOD/FI:n/switch[/switch[s] ] 


MCR>QUE queuename: jobname/MOD/FI:n/switch[/switch[s] ] 


DCL Qualifiers MCR Switches 

/COPIES:n /COr:n 

/ [NO]DELETE / (NO]DEL 
Notes 


When you issue the PRINT or SUBMIT command, you specify 
"attributes" of the QMG job. SET QUEUE changes the matching 
attribute. You cannot change the attributes of an active job. 

You can change some attributes of files that make up a QMG print 


job by specifying the FILE POSITION:n (FI:n) qualifier in the SET 
QUEUE command line. 


4.7 HOLD (QUE /HO) AND RELEASE (QUE /REL) COMMANDS 
You can specify that a job be held when you issue your PRINT or SUBMIT 


command. You can also hold jobs with the HOLD command and release 
such jobs with the RELEASE command. 


4.7.1 HOLD (QUE /HO) 


HOLD (QUE /HO) blocks a job in its queue until it is explicitly 
released. 


Format 
DCL>HOLD/JOB queuename jobname 
DCL>HOLD/ENTRY:nnn 
MCR>QUE queuename:jobname/HO 


MCR>QUE /EN:nnn/HO 


4.7.2 
RELEA 


Forma 


4.8 
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RELEASE (QUE /RE) 
SE (QUE /RE) unblocks a job that has been held in queue. 
c 
DCL>RELEASE/JOB queuename jobname 
DCL>RELEASE/ENTRY:nnn 
MCR>QUE queuename: jobname/REL 


MCROQUE /EN:nnn/REL 


DELETE (QUE /DEL) COMMAND 


DELETE deletes queues or QMG jobs by name or by the job's unique entry 


numbe 


Forma 


Notes 


De 
c 

DCL>DELETE/JOB queuename jobname[FILE POSITION:n] 
DCL>DELETE/ENTRY:nnn[/FILE POSITION:n] 

MCR>QUE queuename:jobname/FI:n/DEL 


MCR>QUE /EN:nnn/FI:n/DEL 


Use these commands to delete a job in a queue by specifying 
either the job's entry number or job name. You can also delete a 
Single file in a job by specifying the /FILE POSITION:n (/FI:n) 
qualifier. 


Nonprivileged users can delete only their own jobs; privileged 
users can delete any job. 


There can be more than one job in a queue with the same name. 
The DELETE command will delete the first job of a given name in 
the queue. You can distinguish between jobs with the same name 
by using the unique entry number instead. 


APPENDIX A 


ERROR MESSAGES 


A.1 BATCH PROCESSING ERROR MESSAGES 


Commands in batch jobs can send error messages that appear in your 
batch log. 


In addition, the batch processors themselves can send error messages 
concerning your batch jobs. Some of these messages result from system 
problems and are returned to the operator's console. Others reflect 
difficulties in processing your batch job and are returned to your 
batch log. 


A.1.1 Error Messages in Batch Logs 
BPR -- Batch file already open 


Explanation: QMG or BPR attempted to open the specified file 
when it was already open. 


User Action: System problem. See your operator or system 
manager. 
BPR -- Batch file close failure 


Explanation: BPR failed to close the specified file. 


User Action: The batch job should not be affected. Check the 
UFD to see if the file is locked. If so, issue the DCL UNLOCK 
command or the MCR PIP/UN command. 


BPR -- Batch file deletion failure 


Explanation: The /DELETE qualifier to the SUBMIT command failed 
to execute. 

User Action: Check the directory. The file may not be in the 
directory, or the batch job lacked delete access to the file. 
Delete the file with the DCL DELETE command. 


BPR -- CPU time limit exceeded, user job terminated 


Explanation: The batch job ran longer than the /TIME qualifier 
to the JOB command permitted. 


User Action: Retry the batch job and increase the amount of (pu 
time using the /TIME qualifier. 


BPR 


BPR 


ERROR MESSAGES 


-- I/O error 


Explanation: The batch processor failed to read from or write to 
the virtual terminal, or the batch processor was unable to open 


the batch file. 


User Action: Retry the batch job. This may indicate a system 


error. See your operator or system manager. 


~~ Virtual terminal I/O was aborted 


Explanation: The task sending I/O to the virtual terminal 
aborted. 


User Action: None. 


BPR -- Label label undefined 


BPR 


BPR 


BPR 


BPR 


BPR 


was 


Explanation: The batch job specified a label that was not in the 


job. 


User Action: Check the job to see that the label is present 


in 


proper form. The label must begin with a dollar sign ($) and end 


with a colon (:). 


-- Log file directory not found - aborted batch job 


Explanation: The SUBMIT command included the /NOPRINT qualifier, 


but the batch job cannot find the directory for the batch log. 


User Action: See your system manager. 


-- Logon privilege violation 
Explanation: The $JOB command gave an incorrect UIC. 


User Action: Check the command for proper syntax and retry 


the 


job. For nonprivileged users, the UIC in $JOB must match the 


login UIC in effect when the SUBMIT command was entered. 


-- Output request from incorrect virtual terminal 
Explanation: System error. 


User Action: See your operator or system manager. 


-- Spawn failure 
Explanation: System error. 


User Action: See your operator or system manager. 


-- Specified maximum CPU time too large 


Explanation: The largest amount of CPU time that may 
Specified is 65535. minutes (1092 hours, 15. minutes) 


User Action: Specify less CPU time. 


be 
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BPR -- Syntax error 


Explanation: A command line in the batch job does not start with 
a dollar sign ($), or special batch commands (Table 2-1) have 


improper syntax. 


User Action: Check the batch file for proper s 
the job. 
BPR -- Syntax error -- $JOB does not appear first 


Explanation: $JOB logs in the user batch 


job 


yntax 


on 


terminal and must appear first in the batch file. 


and retry 


the virtual 


User Action: Edit the batch file so that $JOB appears first. 


BPR -- Virtual terminal output too long for buffer 


A.l. 


BPR 


BPR 


BPR 


ide) 
hg 
70 


Explanation: A stream of characters from 
was too long to fit in a storage buffer. 


User Action: Make sure that the task 


2 Error Messages to the Operator's Console 


-~- Batch file input error 


the 


virtu 


outputs 
LINE-FEED characters when performing terminal I/0. 


Explanation: BPR could not read from the batch file. 


User Action: Check the batch file status. 
in the directory. 
-- Batch job jobname still in progress 


Explanation: System error. QMG attempted 
while another job was in progress. 


User Action: Inform the system manager. 


-- Error during send to QMG 
Explanation: System error. 


User Action: Inform the system manager. 


Explanation: System error. 


User Action: Inform the system manager. 


al terminal 


RETURN and 


The file may not be 


to start the batch job 


An 


SPR 


should be 


submitted including the console output and any other relevant 
information. If possible, reproduce the error. 
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BPR -- Incorrect Emit Status Block (ESB) address returned by spawned task 


Explanation: System error. 


User Action: Inform the system manager. 


BPR -- Log file close failure 
Explanation: BPR failed to close the log file. 
User Action: Check the log file status. The device may not be 
available or the file may not be in the directory. 
BPR -- Log file open error 
Explanation: BPR failed to open the log file. 
User Action: Check the log file destination. The device may be 
write-locked. 
BPR -- Log file output error 
Explanation: BPR failed to write to the log file. 
User Action: Check the log file status. The device may not be 
available or the file may not be in the directory. 
BPR -- Output request from incorrect virtual terminal 
Explanation: System error. 


User Action: Inform the system manager. 


BPR -- Unable to create virtual terminal 
Explanation: The system does not support virtual terminals. 


User Action: A new system generation is required. 


A.1.3 Error Messages from the Card Reader Processor 
The User Action suggested for these errors is directed to both 
privileged and nonprivileged users. In most cases where the 
Suggestion to see your operator or system manager is included, the 
condition can only be corrected by a privileged user. 


CRn -- Reader spooled 


Explanation: The card reader has been initialized and is ready 
to read cards. 


User Action: None. 


CRn 


CRn 


CRn 


CRn 


CRn 


CRn 


CRn 
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-- Reader unspooled 


Explanation: The card reader processor has been removed. Jobs 
can no longer be read. 


User Action: None. 


-- Job (jobname) was entered in queue (queuename) 


Explanation: A job has been successfully read and entered in a 
queue. 


User Action: None. 
-- Illegal SSUBMIT or SPRINT card - job flushing 
Invalid card was " ". 

Explanation: A syntax error was encountered. 

User Action: Repunch the control card and resubmit your card 
deck. 

-- SPASSWORD card illegal or missing - job (jobname) flushing 
Explanation: A syntax error was encountered. 

User Action: Repunch the control card and resubmit your card 
deck. 
-- Invalid account was given - job (jobname) flushing 

Explanation: The account information taken from the /USER:userid 
qualifier and the $PASSWORD card do not match any entries in the 
account file. 

User Action: Inspect your control cards and see if your password 
or userid was mispunched. 

-- Sequence number check - job (jobname) flushing 

Invalid card was " ". 

Explanation: The CRP read a card whose sequence number in 
columns 72 through 80 was not larger than the sequence number of 
the previous card. 

User Action: Replace the $SUBMIT card with a $PRINT card to get 
a listing of your card deck. Determine where your cards got out 
of sequence. 


-- Job (jobname) flushing due to operator request 


Explanation: An operator issued a command that aborted your job 
while it was being read. 


User Action: See your operator or system manager. 
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CRn -- Queue (queuename) does not exist - job (jobname) flushing 


Explanation: 


The queue specified for your job (either by default 


or explicitly with the /QUEUE:queuename qualifier) does not 
exist. 

User Action: Repunch the SSUBMIT or SPRINT card to specify an 
existing queue. 

CRn -- Queue (queuename) marked for delete - job (jobname) flushing 
Explanation: The queue specified for your job is marked for 
deletion and no new jobs may be entered into it. 

User Action: See your operator or system manager. 

CRn -- No queue file space available - job (jobname) flushing 

Explanation: The queue file QUEUE.SYS is full and no more jobs 


can be entered 


User Action: 
reinitialized. 


in any queues. 


Wait until the queue file has emptied o 


Resubmit your card deck. 


CRn -- Card reader not ready 


CRn 


Cr 
bal 
eo} 


CRn 


CRn 


Explanation: 
emptied while 


User Action: 


Usually, this message means that the 


r been 


hopper was 


a job was being read. This message may also be 
given if a pick check, read check, or stack check occurred. 


Check the card reader. Put more 


cards 


hopper and push the RESET button to start reading aaain. 


-- Illegal erro 
Explanation: 


User Action: 


-~ Account file 


Explanation: 
opened. 


User Action: 


-~ Account file 


Explanation: 
closed. 


User Action: 


-- Account reco 


Explanation: 
not be read. 


User Action: 


r message number = nn - parameter address = 


System error. 


See your operator or system manager. 


open error 


System error. The account file 


See your operator or system manager. 


close error 


System error. The account file 


See your operator or system manager. 


rd locked 


could 


could 


System error. A record in the account file 


See your operator or System manager. 
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in the 


nnnnnn 


not be 


not be 


could 


CRn 


CRn 


CRn 


CRn 


Crn 


CRn 


CRn 


CRn 


CRn 


-- Couldn't fi 
Explanation: 


User Action: 


-- Account fil 


Explanation: 
account file. 


User Action: 


~~ Card reader 
Explanation: 


User Action: 


-~- Output file 


Explanation: 
contents of a 


User Action: 


-- Output file 
Explanation: 


User Action: 


-- Output file 
Explanation: 


User Action: 


-- Error code 
Explanation: 


User Action: 


-- Send direct 


User Action: 


-- Exiting due 


Explanation: 
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nd physical LB 
System error. 


See your operator or system manager. 


e read error nn 


System error. An error occurred in reading the 
See your operator or system manager. 

read error nn 

An error occurred in reading a card. 

See your operator or system manager. 

write error nn 

System error. An error occurred in copying the 


card to the card image file. 


See your operator or system manager. 


open error nn 
The card image file could not be opened. 


See your operator or system manager. 


close error nn 
The card image file could not be closed. 


See your operator or system manager. 


nn returned by QMG - function code of packet sent = 
System error. 

See your operator or system manager. 

ive failed - DSW=nn 

System error. 

See your operator or system manager. 

to fatal error 

An unrecoverable error condition occurred, causing 


CRP to exit immediately. 


User Action: 


See your operator or system manager. 


nnn 
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A.2 OUTPUT DESPOOLER ERROR MESSAGES 


All of these messages indicate a FATAL exit status for the job. These 
error messages from the output despooler task appear on the operator's 
console and in the listing on the output device. When these errors 
occur, the despooler task prints the job flag pages first and then the 
error messages on the first page of the listing. 


The messages are preceded by the name of the output despooler (desp, 
in the following list), This name is derived from the name of the 
output device owned by the despooler, such as, LPO: and TT2:. 

I/O error code numbers are explained in the IAS/RSX-11 I/O Operators 
Reference Manual. 


desp -- Attempt to space nn pages beyond eof on- filespec 


Explanation: A privileged user's START/PROCESSOR command 
attempted to start beyond the end of the specified file. 


User Action: Correct the command and retry. 


desp -- I/O Error nn on file- filespec 


Explanation: The task encountered an I/O error nn, which is’ the 
I/O error code number. These codes are explained in the 
IAS/RSX-11 I/O Operations Reference Manual. 


User Action: Look up the error and take corrective action. 


desp -- Job limit of nn pages exceeded on file- filespec 


Explanation: The PRINT command included the /PAGES:nn qualifier. 
The job exceeded this limit. 


User Action: Shorten the file or issue the PRINT command with a 
higher limit. 


desp -- Open error nn on file- filespec 
Explanation The task could not open the file named in the error 


message for output. The vaiue nn is the I/O error code number. 
These codes are explained in the IAS/RSX-1l I/0 Operations 
Reference Manual. 


User Action: Check the directory listing for the state of the 
file. Look up the error. 


desp -- Print error nn on file- filespec 


Explanation: The task could not print the file named in the 
error message. The value nn is the I/O error code number. These 


codes are explained in the IAS/RSX-1l1 I/0 Operations Reference 
Manual. 


User Action: Check the directory listing for the state of the 
file. Look up the error. 


ERROR MESSAGES 


A.3 DCL AND MCR ERROR MESSAGES FROM QUEUE MANAGER COMMANDS 


These error messages appear on your terminal as you issue DCL or MCR 
commands. 


The error message is preceded by the first three letters of the 
erroneous command. For instance, the message 


-- JOB DOES NOT EXIST 


might result from several commands, including HOLD or DELETE. Thus, 
you might see either of the following error messages: 


HOL -- JOB DOES NOT EXIST 
DEL -- JOB DOES NOT EXIST 


If your CLI is MCR, the error message is also preceded by the first 
three letters of the command. 


QUE -- JOB DOES NOT EXIST 
The messages are listed in alphabetical order. 
The User Action suggested for these errors is directed to both 
privileged and nonprivileged users. In most cases where the 
Suggestion to see your operator or system manager is included, the 
condition can only be corrected by a privileged user. 


com -- Bad queue name 


Explanation: The queue name included illegal or too many 
characters. 


User Action: Try a new queue name. Limit: six Radix-50 
characters. 
com -- QMG not active 


Explanation: The Queue Manager task is not active. It may be 
Stopped, aborted, not running, not installed, or the like. 


User Action: Wait and retry the command. If QMG does not 
return, see your operator or system manager. 


com -- Processor does not exist 
Explanation: A command named a device that is not set spooled. 


User Action: Retry the command with the proper device name. 


com -- Directive failure 
Explanation: System error. 


User Action: See your operator or system manager. 


ERROR MESSAGES 


com -~ Illegal argument value 


Explanation: A command specified an illegal argument for a 
qualifier (switch). 


User Action: Check for proper value range and retype. the 
command. 
com -- Bad processor name 


Explanation: The processor name includes invalid or too many 
characters. 


User Action: Retry the command with the proper processor name. 
Names are limited to six Radix-50 characters. Print processors 
must be named after the device the control, such as, _ LP2: 
controlled by LP2. Batch processors must have names in the form 
BAPn. Applications processors can have any legal name. 


com -- I/O Error 
Explanation: System error. 
User Action: Try again. See your operator or system manager, if 
the error persists. 

com -- Job does not exist 
Explanation: A command named a job that does not exist in the 
form the command recognized or under the name the command 
recognized. The job name includes UIC. 
User Action: Issue SHOW QUEUE (QUE/LI). Determine the name and 


Status of the job. Check for the proper command syntax and 
retype the command. 


com -- Operation inconsistent with job state 


Explanation: A command attempted action inconsistent with the 
job state. 


User Action: Issue SHOW QUEUE (QUE/LI). Determine the status of 
the job. Check for the proper syntax and retype the command. 


com -- Queue does not exist 


Explanation: A command named a queue that does not exist in the 
current system. 


User Action: Issue SHOW QUEUE (QUE/LI). Retry the command with 
the name of an existing queue. See your operator or system 
manager. 
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com -- Queue file full 


Explanation: The queue file [1,7]QUEUE.SYS on LB for RSX-11M or 
SP for RSX-11M-PLUS is full. 


User Action: Wait and try again. If the error message persists, 
see your operator or system manager. 
com -- Queue marked for delete 


Explanation: New jobs cannot be added to a queue marked for 
delete. 


User Action: Send the job to another queue. 


com -- Redundant operation 


Explanation: A command requested an operation that has_ been 
done. 


User Action: None. 


GLOSSARY 


This glossary contains brief definitions of terms used in the 
RSX-11M/M-PLUS Batch and Queue Operations Manual. 


es eS 


ACTIVE JOB 
An active job is a job currently being processed. 

APPLICATIONS PROCESSOR 
An output despooler written by the user for a special purpose or 
specific job. See your system manager for information on any 


applications processors in your installation. Applications 
processors are treated like print processors in most cases. 


‘BATCH COMMAND (RSX-11M-PLUS | onl y) 


_ Abatch command is’ “a. Cl can 
“commands must be--preceded by. oll, 
position: of | the “command « -ine.. -Comp 
= Sommand. oo 


-thare- are “ewo kinds of ‘Oxccne 
_ BATCH JOBS and QMG BATCH JOBS. 


BATCH LOG (RSX-11M-PLUS only) oe ae . 
_. Bach QMG - batch job produces a Poa chat ‘represents. the output. ee 
-.. "appeared" on the virtual — terminal. You'.can save a Seraneh : 
~; copy of the log. ile. You ‘can also: include comments ‘in. the ee 


ve o=fite. Van @an nrint thea lac file. ee 


im ee oyu wad Ps bse the dios | a a 


Regardless of: he number of user Sob in the: omc A obe there - Witt 
- be only one log. — You can differentiate between user jobs within’ 
~ “the log by using the log label field of. the JOB command that logs: 

in each: batch job. 
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CLI 
An acronym standing for Command Line Interpreter. CLIs act as 
interpreters between people and computer operating systems. 
(See MCR and DCL.) 

COMMAND 


AR command is an inst 


to perform a particu 


tion er request for the operating svstam 


ts 


COMMAND LINE INTERPRETER 
See CLI. 


COMMAND QUALIFIER 


A command qualifier (DCL) or job switch (MCR) is a command 
element preceded by a siash (/) that alters the action of a 
command. See FILE QUALIFIER. 


on ‘RSX-1IM- PLUS only," ‘any. Ato cant toe ‘that - is. required: input. a 
a ~ batch . job. This -is a: ‘special. definition. used.in. batch. process tg 
*:* on RSX=1LIM-PLUS. | The. ‘term. "data™ ‘includes not only. data. oe the. 
. conventional » ‘sense . “of: information ‘to be. ar by. a program 
oy but. reapnegh “responses to ‘prompts - “from, CLI Y : 


5 eR ave te be, Eyped 
DCL 
DIGITAL Command Lanquage. An RSX-11M/11M-PLUS supported CLI 


designed for ease of use. DCL uses English language words and 
Prompts you for necessary parameters. Compare with MCR. 
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DEFAULT 


A default is a value or condition that is assumed by the 
operating system and performed automatically. 


For example: The default queue for the PRINT command is’ PRINT. 
There are other queues availabie on the system, but, to place 
your job in one of these other queues, you must specify the queue 
in the PRINT command. If you do not specify one of these other 
queues, your print job will default to the queue called PRINT. 


DESPOOLER 


A print processor may also be called a despooler. 
DEVICE 


Any peripheral hardware or software connected to the processor 
and capable of receiving, storing, or transmitting data. Line 
printers and terminals are examples of record-oriented devices. 
Magnetic tapes and disk devices are examples of mass-storage 
devices. Terminal line interfaces and interprocessor links are 
examples of communication devices. 


DEVICE-SPECIFIC QUEUE 


Some print queues have names derived from the names of the output 
devices on the system, such as LPO, named after LPO:. These 
queues are needed for certain system tasks that send print jobs 
to line printers directly. These queues will usually send their 
output to the printer they are named after, but they need not do 
SO. 


DIGITAL COMMAND LANGUAGE 
See DCL. 
DISK 
A disk is a high-speed, random access mass storage device. 


RSX-11M/M—PLUS systems use disks as their major form of 
mass-Storage device. 


ERROR MESSAGE 


Error messages are sent by the system when some action you have 
requested fails. 
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STATUS CODE 


All system tasks on the RSX-11M/M-PLUS systems, DCL and MCR 
commands, and utilities send a status-return code when they have 
completed their operations. The codes are: 


SUCCESS Results should be as expected 

WARNING Task succeeded but irregularities are 
possible 

ERROR Results unlikely to be as expected 

SEVERE ERROR One or more fatal errors, or ABORT 
encountered 


As a rough rule, you can expect that any error message you 
receive on your terminal will reflect an exit status less than 
success. Again, roughly, any error message tagged *FATAL* will 
probably represent a status return of ERROR or SEVERE ERROR, and 
any error message tagged *DIAG* will probably represent a status 
return of WARNING. These are by no means hard and fast 
standards. Each system task follows its own rules. 


You can use the ON and IF commands inside your batch job _ to 
program responses to status-return codes job. 


FIELD 


FILE 


FORMS 


FORM 


A field is a portion of a command or a command element. 
QUALIFIER 


A file qualifier (DCL) or switch (MCR) is a command element 
preceded by a slash (/) that alters or modifies the action of a 
command as it affects that particular file. Depending upon the 
position of the file qualifier (switch), all or only certain 
files may he affected. See COMMAND QUALIFIER. 


All standard-length forms use form feeds, which are set on _ the 
hardware. All nonstandard forms use simulated form feeds, which 
are set through the software by replacing the form feed character 
with the appropriate number of line feeds. 


Whether a form length is standard or not depends on whether it 
can be set using hardware facilities on the line printer. If it 
can be set on the line printer, then it is a standard form 
length. 


Your system manager can tell you what /FORM:n option to _ specify 
in your PRINT command for any particular form. In this way, your 
print jobs will be queued for the proper printer and held until 
the proper forms are placed on the printer. 


FEED 


A form feed is a character that directs the line printer to move 
to the top of the next continuous-feed form page. The line 
printer moves past the perforation in the paper to the top of a 
new form. 
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GENERAL QUEUE 


Queues with names not derived from hardware devices. Each 
hardware output device has a queue named after it. See 
DEVICE-SPECIFIC QUEUE. All other queues are general, including 
the default PRINT queue, other print queues, and all batch 
queues. 


HARD-COPY TERMINAL 


Terminals that print output on paper are called hard-copy 
terminals. 


INDIRECT COMMAND FILES 


A means of automatically passing commands for processing on an 
RSX-11M/M-PLUS Operating System. Indirect command files remain 
active at the terminal from which they are _ invoked. Indirect 
command file directives permit symbol substitution, testing 
system functions, and such programming techniques as_ loops, 
counters, and subroutines. 


INSTALLATION 


The installation is the full computer system (hardware and 
software) at your location. This includes the operating system, 
the programming languages, and all applications tasks, as well as 
the computer and all its hardware devices. 


INTERACTIVE TERMINAL 


A standard hardware terminal with a keyboard from which you can 
type responses to prompts. Compare with VIRTUAL TERMINAL. 


LINE PRINTER 


An output device that prints files a line at a time. Even if 
your system does not have an actual hardware device of the 
line-printer type, it will have some device designated as_ the 
system output device and taking the part of the line printer. 


LOG 


A log is a record of activity. In this manual, the term refers 
to a file produced by a batch processor. See BATCH LOG. 


LOGICAL PAGE 


The line printer moves to the top of a new PHYSICAL PAGE each 
time a form-feed character (CTRL/L) is encountered. If you use 
the /LENGTH qualifier on the PRINT command, you define a LOGICAL 
PAGE length. If the line printer does not encounter a form-feed 
character within the length of the logical page, it will 


4 . : ~ om: an mee em 
automatically supply one at the end cf the lsgical page, moving 


the printer to the top of the next physical page. 
LOGIN 
The LOGIN command identifies you to the operating system and 


informs the system that you have certain privileges and are using 
a particular terminal. 
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LOGOUT 


The LOGOUT command informs the operating system that you have 
finished using a particular terminal. 


MCR 


Monitor Console Routine. An RSX-11M/11M-PLUS supported CLI. 
Most MCR commands use mneumonics in strict syntax. See DCL. 


NONPRIVILEGED USER 


Nonprivileged users have access to most of the system's 
facilities but cannot alter the system. 


OPERATING SYSTEM 


An operating system is a set of tasks that collectively automate 
the Management of computer resources to provide efficient 
computer operation. 


An operating system is used for user communication with the 
computer, for program development, and for scheduling the use of 
the central processing unit and its peripherals for efficiency. 


OPERATOR 
The person who is in direct charge of the computer. 


OPERATOR'S CONSOLE 


A hard-copy terminal, usually located near the computer, used by 
the operator. This terminal has the logical name CO: and 
records certain system information. 


PERIPHERAL DEVICES 


Any unit, distinct from the CPU and memory, that can provide’ the 
system with input or accept output from it, is called a 
peripheral device, or peripheral. 


PHYSICAL PAGE 


A physical page is the part of a ne fo 
perforation and the next perforation. tand 
paper has a physical page length of 66 Fines: Each time the line 
printer encounters a form-feed character (CTRL/L), the line 
printer moves the paper to the top of the next physical page. 
Compare LOGICAL PAGE. 


rm between one 
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PRINT COMMAND 


The PRINT command queues files for printing on a line printer. 
The PRINT command may also be used to enter jobs in queues for 
other output devices, such as plotters or punches. The PRINT 
command is to print jobs as the SUBMIT command is to batch jobs. 


PRINT PROCESSOR 


Each spooled output device has a print processor, a task that 
attaches the device and directs output to it. The Queue Manager 
handles the orderly printing of files through the print 
processor. 
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PRINT QUEUE 


PRINT queue refers to the default queue for print jobs. A _ print 
(lowercase) queue refers to any queue that is used to contain a 
list of print jobs. 


PRIORITY 


Priority is a rank assigned to a task to determine its precedence 
in obtaining system resources when the task is run. The default 
priority for a task is 50. QMG jobs are also assigned a 
priority. The default priority for a job is 50. 


PRIVILEGED USER 


Privileged users can alter the operating system through the use 
of privileged commands. 


QMG PRINT JOB 


A QMG print job consists of one or more files to be printed at 
the same time. Jobs in a QMG print job go to the same line 
printer in the order they were listed and without interruption. 
The print job has a name derived from the name of the first file 
in the job or from a name given in the PRINT command. 


QUALIFIER 


See COMMAND QUALIFIER and FILE QUALIFIER. 


QUEUE 


A queue is a waiting line of jobs that are scheduled or processed 
according to system or user priorities. 


QUEUE FILE 


A disk file used by the Queue Manager for storage of control 
information and entries for all batch and print processors, all 
jobs and files to be processed, and all queues. On RSX-11M this 
file is LBO:[1,7]QUEUE.SYS and on RSX-11M-PLUS the file is 
SP0:[1,7]QUEUE.SYS. Since this information is retained on disk, 
your job will not be lost should the system stop operating. 


QUEUE MANAGER 


The Queue Manager (QMG) is a system program that provides for the 
orderly processing of print and (on RSX-11M-PLUS only) batch 
jobs. 
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SEVERE ERROR 


Exit status code. This is usually returned when one or _ more 
fatal errors are encountered or a task is aborted. When used in 
a sequence control command, this term should be typed as a single 
word: SEVEREERROR. 


SPOOL 


This is an acronym for Shared Peripheral Operations On Line. It 
refers to the process of sending output to a peripheral device, 
particularly a line printer, in an orderly fashion. 


Many users and tasks may be directing output to the line printer 
at the same time. Rather than print three lines of one file and 
then two of another, as might happen if the output was passed 
directly to the line printer, the output is sent to a mass 
storage device -- usually a disk -- to be saved in separate 
files. 


The process of saving files on disk in this fashion is called 
spooling. The orderly transfer of these files from the disk to 
the output device is called despooling. 

SPOOLED DEVICE 


A spooled device is a line printer or other output device under 
control of the Queue Manager. Spooled devices are initialized 
with certain attributes. 


SUCCESS 


Exit status code. Results should be as expected. 

SYNTAX 
Syntax is the form that a command must follow. Misspelled words 
are the most common syntax errors, but misplaced delimiters are 
also common. 


SYSTEM MANAGER 


The person responsible for setting policies for using the 
RSX-11M/M-PLUS Operating System. 
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TERMINAL 


terminal is a hardware device with two functions: {1}) sending 
input to the operating system from a keyboard and displaying it 


and (2) receiving output from the operating system and displaying 
Les 


UFD 


All files on mass storage devices are cataloged in User File 
Directories, or UFDs. The UFD is a file listing all the files 
included in the Directory. The UFD is a two-number code in the 
form [g,m] that is included in every file specification, either 


explicitly or by default, and that the file system uses to locate 
the file. 


In most cases, the UFD will be the same as the User 
Identification Code, or UIC, under which you logged in. See UIC. 


UIC 


User Identification Code. Each RSX-11M/11M-PLUS uSer has a 
two-number identification code enclosed in brackets that is used 
(with password) for logging in. The number is in the form 


[g,m,], with g giving the user's group number and m giving the 
user's member number. 


WARNING 


Exit status code. The task succeeded, but irregularities are 
possible. 
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Active job, 
definition, Gloss-l 
/AF job switch, 
QUE /MOD command, 
SUB command, 3-15 
/AF switch, 

PRI command, 2-6 
/AFTER job qualifier, 
SET QUEUE command, 

/AFTER qualifier, 
PRINT command, 2-6 
SUBMIT command, 3-15 

Applications Processor, 
See Queue Manager (QMG) 

special applications, 
definition, Gloss-1l 


2-20 


2-20 


Batch command, 
CLI commands, 3-2 
definition, Gloss-l 
dollar sign, 1-8, 3-2 
format, 3-2 
label, 3-2 
line continuation, 
Batch job, 
See also OMG batch job 
See also User batch job 
allocating device, 
ALLOCATE command, 
card deck, 3-23 
card reader input spooling 
example, 3-24 
deallocating device, 
DEALLOCATE command, 
definition, Gloss-l 
dismounting volume, 
DISMOUNT command, 
mounting volume, 
MOUNT command, 
queuing, 3-14 
scheduling, 1-7 
submitting, 
Batch log file, 3-2, 3-19 
definition, Gloss-l 
example, 3-20 to 3-23 
line identifiers, 
DATA, 3-20 
SKIP, 3-20 
TERM, 3-20 
Batch processing, 1-7 
definition, Gloss-2 
Batch processor, 
definition, Gloss-2 
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/BATCH qualifier, 
SHOW QUEUE command, 2-16 
Batch-specific command, 3-2 

command summary, 3-3 

definition, Gloss-1 

line continuation, 
BPR, 3-1 

See Batch processor 
/BR switch, 

QUE /LI command, 
/BRIEF qualifier, 

SHOW QUEUE command, 
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Card deck, 
example, 
format, 

SEOJ, 3-24 
SJOB, 3-24 
SPASSWORD card, 3-24 
SPRINT card, 3-24 
SSUBMIT card, 3-24 
sequence field, 3-26 
Card reader input spooling, 
3-23 
Card Reader Processor (CRP), 
3-23 
error recovery, 
operation, 3-27 

/CO file switch, 
PRI command, 2-6 
QUE /MOD command, 

/CO job switch, 

PRI command, 2-4 
QUE /MOD command, 2-20 

Command Line Interpretor, 
See CLI 
definition, Gloss-2 

Command summary, 4-1 

Comment in batch job, 
example, 3-12 
format, 3-12 

CONTINUE command, 

See also ON and IF commands 
format, 3-8 

/COPIES file qualifier, 

PRINT command, 2-6 
SET QUEUE command, 
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3-27 
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Data, batch job, 
definition, Gloss-2 
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DATA command, 3-5 
example, 3-6 to 3-7 
format, 3-6 
qualifiers, 3-6 

DCL (DIGITAL Command 

Language), 
definition, Gloss-2 

/DE file switch, 

PRI command, 2-6 
SUB command, 3-17 

/DEL file switch, 

QUE /MOD command, 2-21 

DELETE command, 
example, 2-11 
format, 2-10 

/DELETE file qualifier, 
PRINT command, 2-6 
SET QUEUE command, 2-21 
SUBMIT command, 3-17 

Despooler, 
definition, Gloss-3 

/DEVICE qualifier, 

PRINT command, 2-6 

SHOW QUEUE command, 2-15 
/DOLLARS qualifier, 

DATA command, 3-6 


/EN switch, 
QUE /DEL command, 2-10 
QUE /LI command, 2-16 
/ENTRY qualifier, 
DELETE command, 2-10 
SHOW QUEUE command, 2-16 
EOD command, 
format, 3-7 
EOJ command, 
format, 3-5 
Exit Status Code, 
definition, Gloss-—4 


/FI file switch, 
QUE /MOD command, 2-21 
/FI switch, 
QUE /DEL command, 2-11 
/FILE POSITION file qualifier, 
SET QUEUE command, 2-21 
/FILE POSITION qualifier, 
DELETE command, 2-11 
/FILES qualifier, 
SHOW QUEUE command, 2-15 
/FL switch, 
PRI command, 2-5 
/FLAG PAGE qualifier, 
PRINT command, 2-5 
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/FO job switch, 

QUE /MOD command, 2-20 
/FO switch, 

PRI command, 2-5 

QUE /LI command, 2-16 
Form, 

special hardcopy, 1-2 
Forms, 

definition, Gloss-4 
/FORMS job qualifier, 

SET QUEUE command, 2-20 
/FORMS qualifier, 

PRINT command, 2-5 

QUE /LI command, 2-16 
/FU switch, 

QUE /LI command, 2-15 
/FULL qualifier, 

SHOW QUEUE command, 2-15 


GOTO command, 3-8 
See also ON and IF commands 
example, 3-9 
format, 
label, 3-9 


/HO job switch, 
SUB command, 3-16 
/HO switch, 
PRI command, 2-4 
HOLD command, 
format, 
entry number, 2-22 
job name, 2-22 
/HOLD qualifier, 
PRINT command, 2-4 
SUBMIT command, 3-16 


IF command, 

See also STOP, CONTINUE, 
GOTO commands 

example, 3-12 
format, 3-11 

Indirect command file, 
definition, Gloss-5 
example, 3-13 
format, 3-13 

Interactive terminal, 
definition, Gloss-5 


/JO switch, 

PRI command, 
Job, 

deleting, 2-10 

holding, 2-1 

modifying, 2-1 

releasing, 2-1 
JOB command, 3-3 

example, 3-4 

format, 3-4 

qualifiers, 3-4 
/JOBCOUNT job qualifier, 

SET QUEUE command, 2-20 
/JOBCOUNT qualifier, 

PRINT command, 2-3 
Jobname= job switch, 

SUB command, 3-16 
Jobname= log file switch, 

SUB command, 3-17 
Jobname parameter, 

DELETE command, 
Jobname switch, 

QUE /LI command, 
Jobname= switch, 

PRI command, 2-4 
/JOB PAGE qualifier, 

PRINT command, 2-6 
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2-16 


/LE job switch, 

QUE /MOD command, 
/LE switch, 

PRI command, 2-5 
/LENGTH job qualifier, 

SET QUEUE command, 2-20 
/LENGTH qualifier, 

PRINT command, 2-5 
/LI switch, 

QUE /LI command, 
/LI:B switch, 

QUE /LI command, 
Line printer, 

definition, Gloss-5 
/LI:P switch, 

QUE /LI command, 

2-15 to 2-16 
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QUE /MOD command, 
/LO log file switch, 
SUB command, 3-17 
/LOGFILE qualifier, 
SUBMIT command, 3-17 
Logical page, 

definition, Gloss-5 
/LOW switch, 

PRI command, 2-4 
/LOWERCASE job qualifier, 

SET QUEUE command, 2-20 


2-20 


2-15 


2-16 


2-20 
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/LOWERCASE qualifier, 
PRINT command, 2-4 


/NAME log file qualifier, 
SUBMIT command, 3-17 
/NAME qualifier, 
SPRINT card, 3-25 
SHOW QUEUE command, 
SSUBMIT card, 3-25 
SUBMIT command, 3-16 
/NAME:jobname qualifier, 
PRINT command, 2-4 
/NOCOPY qualifier, 
DATA command, 3-6 
/NOLO job switch, 
QUE /MOD command, 
/NOLOW switch, 
PRI command, 


2-16 


2-21 


2-4 


ON command, 
See also STOP, CONTINUE, 
GOTO commands 
default setting, 
example, 3-10 
format, 3-10 
/OWNER UIC qualifier, 
SHOW QUEUE command, 2-16 


3-9 


/PA job switch, 
QUE /MOD command, 
/PA switch, 

PRI command, 2-4 
/PAGE COUNT job qualifier, 
SET QUEUE command, 2-20 

/PAGE COUNT qualifier, 
PRINT command, 2-4 
SPASSWORD card, 
format, 3-27 
PRI command, 
file switches, 
format, 2-3 
job switches, 2-3 
/PRIN log file switch, 
SUB command, 3-18 
SPRINT card, 
command qualifiers, 
See PRINT command 
format, 3-26 
PRINT command, 1-3, 
command qualifiers, 
definition, Gloss-6 
example, 2-7 
file qualifiers, 
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3-26 


2-2 
2-3 
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PRINT command (Cont.) 
format, 2-3 
processing, 1-4 to 1-6 
Print job, 
definition, Gloss-7 
queued by system tasks, 
DCL COPY command, 2-12 
maps, logs, listings, 2-12 
PIP, 2-12 
PIP line printer, 2-12 
queued by user tasks, 
opening file on LPn:, 2-14 
»-PRINT, 2-13 
PRINT command, 2-13 
submission notification, 2-2 
/PRINT log file qualifier, 
SUBMIT command, 3-18 
Print processor, 1-3 
See also Despooler 
definition, Gloss-6 
/PRINT qualifier, 
SHOW QUEUE command, 2-16 
/PRIO job switch, 
QUE /MOD command, 2-20 
SUB command, 3-17 
/PRIO switch, 
PRI command, 2-5 
Priority, 
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/PRIORITY job qualifier, 
SET QUEUE command, 2-20 

/PRIORITY qualifier, 
PRINT command, 2-5 
SUBMIT command, 3-17 


QMG batch job, 1-7, 3-2 
definition, Gloss-7 
QUE /DEL command, 
format, 2-10 
QUE /HO command, 
format, 
entry number, 2-22 
job name, 2-22 
QUE /LI command, 2-14 
batch queue, 1-9 
display, 2-16 to 2-17 
format, 2-15 
print queue, 1-9 
QUE /LI display, 1-10 
Switches, 2-15 
QUE /LI:DEV command, 
format, 2-18 


QUE /MOD command, 
example, 2-21 
file format, 

Switches, 2-19 


30b format, 
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QUE /MOD command (Cont.) 
Switches, 2-19 
QUE /REL command, 
format, 
entry number, 2-23 
job name, 2-23 
Queue, 1-1 
assignments, 1-2 
BATCH queue, 
definition, Gloss-2 
definition, Gloss-7 
device, 
definition, Gloss-3 
device-specific, 1-2, 
Gloss-3 
disk file, 
definition, Gloss-7 
disk file (QUEUE.SYS), 
RSX-11M, 1-1 
RSX-11M-PLUS, 1-1 
displaying information, 2-1 
general, 1-2; Gloss-5 
job, 
holding, 2-1 
releasing, 2-1 
status, 
altering, 2-1 
PRINT, 
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Astrea tion, “Cisse 
Queue Manager (QMG), 1-1 

definition, Gloss-7 

dequeuing jobs, 2-1 

output, 1-3 

queuing jobs, 2-1 

special applications, 1-2 
/QUEUE qualifier, 

SUBMIT command, 3-17 
Queuename job switch, 

SUB command, 3-17 
Queuename parameter, 

DELETE command, 2-10 
Queuename switch, 

PRI command, 2-4 
/QUEUE:queuename qualifier, 

PRINT command, 2-4 


/RE job switch, 
QUE /MOD command, 2-21 
SUB command, 3-16 
RELEASE command, 
format, 
entry number, 2-23 
job name, 2-23 
/RES switch, 
PRI command, 2-5 
/RESTART job qualifier, 
SET QUEUE command, 2-21 


/RESTART qualifier, 
PRINT command, 2-5 
SUBMIT command, 3-16 


Sequence Control Commands, 
See also STOP, CONTINUE, 
GOTO and SET ON 
definition, Gloss-8 
/SEQUENCE qualifier, 
SSUBMIT command, 3-25 
SET command, 
format, 3-11 
SET QUEUE command, 
example, 2-21 
file format, 
qualifiers, 2-19 
job format, 
qualifiers, 2-19 
SHOW PROCESSOR command, 
format, 2-18 
SHOW QUEUE command, 
batch queue, 1-9 
display, 2-16 to 2-17 
format, 2-15 
print queue, 1-9 
qualifiers, 2-15 
SHOW QUEUE display, 1-10 
Spool, 
card reader input spooling, 
3-23 
definition, Gloss-8 
spooling output, 2-1 
Spooled device, 1-3, 2-1 
definition, Gloss-8 
line printer, 1-3 
output, 1-3 
Status code, 
ERROR, 3-10 
definition, Gloss-4 
SEVERERROR, 3-10 
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3-11 


definition, Gloss-4 
SUCCESS, 3-10 
definiton, Gloss-4 
WARNING, 3-10 
definition, Gloss-4 
STOP command, 
See also ON and IF commands 


format, 3-8 

SUB command, 3-14 
example, 3-18 to 3-19 
file switches, 3-15 
format, 3-15 
job switches, 3-15 


log file switches, 3-15 


SSUBMIT card, 
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SSUBMIT card (Cont.) 
format, 3-25 

SUBMIT command, 1-7, 3-14 
command qualifiers, 3-15 
definition, Gloss-8 
example, 3-18 to 3-19 
file qualifiers, 3-15 
format, 3-15 
log file qualifiers, 3-15 


/TIME qualifier, 
JOB command, 3-4 
/TR file switch, 
PRI command, 2-6 
SUB command, 3-17 
PRINT command, 2-6 
SUBMIT command, 3-17 
Transparent spooling, 
definition, Gloss-9 
(EDT) WRITE command, 
/TYPE keyword, 
ALLOCATE command, 
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3-14 


{uic] switch, 
QUE /LI command, 2-16 
/UPPERCASE job qualifier, 
SET QUEUE command, 2-21 
/UPPERCASE qualifier, 
PRINT command, 2-4 
User batch job, 1-7 
batch chain, 1-7 
command, 3-2 
comment, 1-8 
creating, 3-1 
data, 3-2 
definition, Gloss-9 
example, 1-8 
/USER qualifier, 
SPRINT card, 3-25 
SSUBMIT card, 3-25 


Virtual terminal, 
definition, Gloss-9 
login UIC, 

default, 3-1 
privileged user, 3-1 


/WAIT keyword, 
MOUNT command, 3-14 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


[] Assembly language programmer 
L] Higher-level language programmer 
(] Occasional programmer (experienced) 
CL] User with little programming experience 
(Li Student programmer 
CL! Other (please specify) 
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